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Are yOU interested in graphics? Have you seen three- 
dimensional graphics displays, like the ones used in TRON or 
The Last Starfighter, and wondered, "Why can't my personal 
computer do something like that?" Yesterday's micros just 
didn't have enough horsepower. Today, things are different. 
Smaller personal computers, such as the Commodore Amiga 
and "the Atari ST, have more power than the minis of ten 
years ago. 

This book will show you the techniques you need to mas- 
ter sophisticated computer graphics. You'll learn about two- 
and three-dimensional graphics programming, line drawing 
and polygon filling, and much more. All of the example pro- 
grams are implemented in the popular C programming lan- 
guage. And since Learning C: Programming Graphics on the 
Amiga and Atari ST is written for the first-time C programmer, 
you'll learn C as well as how to program graphics. 



Equipment and Software 

Learning C: Programming Graphics on the Amiga and Atari ST 
has sample source code for the Commodore Amiga and the 
Atari ST. To use the sample programs, you'll need a Commo- 
dore Amiga with at least 512K. You can also use an Atari 520 
or 1040 ST with either a color or monochrome monitor. The 
programs have been thoroughly tested and work with the Lat- 
tice and Aztec C compilers on the Amiga and the Lattice, 
Alcyon, and Megamax C compilers for the ST. 

Some Definitions 

Before beginning with C and graphics, we'll need to review 
some basic definitions. The compiler is the program which 
translates your C program into machine language, the only 
language the computer can understand directly. The text of the 
C program is called the source code. The compiler translates 
source code into something called an object module. The ob- 
ject module must be linked with other object modules before 
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Not only does Learning C: Programming Graphics on the Amiga 
and Atari ST give you the information you need to begin writ- 
ing your own C programs on the ST or Amiga, but it also 
shows you how to translate advanced mathematical con- 
cepts — the same ones professional programmers use to create 
graphics — into C source code. 

The first sections of this book explain C programming. 
You'll learn all about C in general and the C language con- 
cepts and commands you need to program graphics on the 
Amiga and Atari ST. The appendices even include specific 
information about how to compile and link programs on a 
variety of compilers for the two computers. 

The latter sections of Learning C: Programming Graphics on 
the Amiga and Atari ST illustrate how mathematical concepts 
relate to computer graphics, and how to write C code using 
those concepts in creating dramatic three-dimensional 
graphics. 

All the programs work on both the Amiga and ST be- 
cause of machine. c, a machine-specific library of routines that 
you can add to any of your C programs to create graphics. The 
appendices include specific instructions on how to use this 
powerful library. 

Learning C: Programming Graphics on the Amiga and Atari 
ST assumes you're familiar with your ST or Amiga, have a C 
compiler, and that you know how to program in at least one 
computer language. This book shows you how to write high- 
quality C source code to create executable programs using the 
most popular compilers for the Amiga and Atari ST. (You 
should, though, be familiar with your compiler's operation.) 

All the programs have been tested and are ready to type 
in, compile, link, and use on either the Atari ST or Commo- 
dore Amiga. If you prefer, you can purchase a disk which in- 
cludes all the C source code and executable files by calling 
1-800-346-6767 (in N.Y. 212-887-8525) or by using the coupon 
in the back of this book. 




Learning C: Programming Graphics on the Amiga 

and Atari ST is intended for the programmer who is new to 
the C programming language. It introduces those aspects of C 
programming which are necessary to understand and imple- 
ment the advanced graphics algorithms discussed in Chapters 
7-13. In general, we've assumed you are familiar with pro- 
gramming your computer — that you know how to edit a file, 
run programs, and use the operating system. 

Throughout the text we have tried to emphasize machine- 
independent graphics. All of the machine-dependent functions 
have been isolated in the file machine.c. This means that the 
sample programs in this book will run on any computer, if the 
appropriate machine.c file has been prepared. In fact, the orig- 
inal zbuf program was implemented on an Apollo graphics 
workstation. It should be possible to port all of the example 
programs to the Apple Macintosh, the IBM PC, or even other 
graphics workstations such as SUNs or MicroVAX lis. You 
simply need the necessary machine-dependent functions. 

The graphics algorithms and techniques which are pre- 
sented in this book are usually only found in books about ad- 
vanced graphics programming. We've tried to make these 
algorithms and techniques more accessible to the average com- 
puter programmer. You might think that we talk about every 
algorithm possible, but what's here is really just the tip of the 
iceberg. The last chapter on graphics touches on some aspects 
of graphics programming which haven't been discussed else- 
where in the book. This gives you a glimpse of what's possi- 
ble, even on a personal computer like the Atari ST or 
Commodore Amiga. We've listed several good sources of 
graphics material in Appendix K if you want to learn more. 

It was quite a challenge getting all of the programs to run 
on both the Atari ST and the Commodore Amiga. The biggest 
problems were bugs in the compilers or their libraries. Often 
we would get the program running satisfactorily on the 
Amiga, only to find that it didn't compile on the Atari. After 
working around compiler bugs on the Atari, we would bring 
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Onr tlltOria.1 begins with functions. Functions 

taSs are and why we use them, then look at some spe 
cific C functions. 

.„ A r function is capable of more tnan ju&t «-ai 

(We'll discuss ways around this limitation later.; dot 
lions don't take any arguments; they simply perform some 
type of action. 



Commuting and Cooking: Shorthand 

?o "deS why functions are used, leftfcoka. an ana!; 
™™ Whenever you describe to someone how to do soii™» s 
JSrtIS a^nd of program. Take coctang Jta. «-»» 
One mieht think of a recipe as a program and the chet as in 
SmpuSr The chef works through the recipe one step at a 

" me Some steps are obvious: "Max the sugar and* owning 
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the program can be run. There is a program included as part 
of your specific compiler package — called something like 
"link" or "In" — which takes care of linking the necessary 
modules for you. 

The object modules are often stored in a library. A library 
is simply a collection of object modules which are indexed in 
some war so that the linker can get at the ones it needs to 
make yotr program work. (Some compilers make your job 
very easy by performing the linking stage for you; others force 
you to go through yet another compilation stage by producing 
an assembly language output which must then be assembled 
before you can get an object module*) — » 

Working with Many Computers 

All micros have certain things in common. They all have a 
way of getting input from the user (for example: a keyboard, 
or perhaps a mouse), of displaying information (a monitor or 
TV screen), and of storing it (floppy disks, hard disks, and the 
like). In same respects the Commodore Amiga and the Atari 
ST are very similar computers: They have the same processor 
chip (the powerful Motorola 68000) and they both let you use 
windows and icons. On the other hand, the way in which 
they handle the display screen is very different. The Amiga 
has a verj complex set of screen-controller chips which fill 
areas, draw lines, and move images around the screen. The ST 
uses a simpler screen controller with all of the fancy things 
(like line drawing) implemented in software. This gives the 
Amiga a speed advantage over the ST: The Amiga can do in 
hardware what the ST must do in software, leaving the 
Amiga's processor more time to do computing. 

In an effort to bring these two machines together, we've 
designed i set of graphics routines which utilize a subset of 
each machine's capabilities. It's important to remember the 
goal of ths book: to teach graphics. We'll provide you with 
the tools you'll need to learn more about the specifics of your 
particular computer, whether it's an Atari ST or a Commodore 
Amiga. If you learn C on one computer, you've learned it for 
all computers. The same doesn't apply to BASIC, in which ev- 
ery implementation is a little different (even for the same com- 
puter). In C, you can define your own commands and largely 
ignore a machine's specific hardware and operating system. 
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This makes C a highly portable language; that is to say, the 
same C program will work on many machines, with few (if 
any) modifications. 

The History of C 

The C programming language was developed in 1972 by Den- 
nis Ritchie, then an employee of Bell Laboratories. It devel- 
oped from a language called B, hence the name C. B and C 
share several characteristics, and were influenced by BCPL, 
but neither is a direct descendent of BCPL. Ritchie designed 
and implemented C on the UNIX operating system on the 
DEC PDP-11. C was designed to be a powerful and versatile 
general-purpose programming language featuring ease of ex- 
pression, control of program flow, data structures, and a set of 
operators. C is not a beginner's language, like BASIC or Pas- 
cal. C applications range from low-level operating system 
functions to high-level applications programs, such as word 
processors and spreadsheets. 

C is finding a home in many software-development 
houses. UNIX and MS-DOS are written mostly in C. C is the 
language of choice among most Amiga and ST developers be- 
cause of its power, speed, ease of debugging, and portability. 

C is a compiled language, but not all C compilers are the 
same. There are a variety of schemes a compiler can use to 
translate C into machine language; some compilers are faster 
at translating the C program into machine language, while 
others produce faster executing programs. 

Features of C 

C includes commands to handle strings, files, and floating- 
point math as do other high-level languages like Pascal and 
BASIC, but it's just as much at home with bitwise operations 
(AND, OR, NOT, bit shifting) and memory pointers as Assem- 
bly language. (Don't worry if you're not familiar with these 
terms right now. You'll learn about them as you need them.) 
This makes C a very versatile language, since it has the power 
of low-level assembly language operations and many of the 
features found in high-level languages. 
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The Graphics Library 

The graphics library is presented in Appendix G. Before you 
begin with the rest of the book, you should key in the appro- 
priate library for your computer and compiler. You'll find 
compiling instructions for a variety of compilers; if your par- 
ticular compiler isn't listed, then you'll have to rely on the 
documentation that came with it. 

Once you've entered the appropriate library, try the sam- 
ple program hello. c (Program 1-1). When professional pro- 
grammers start working in a new language, a "hello world" 
prop-am is usually the first one they write. This gets them fa- 
miliar with the compiler and editor they have to use for that 
new language. So let's do the same thing. Make sure you're 
familiar enough with your particular compiler and editor so 
thai you can get the program to run. It should print HELLO 
WORLD! to the screen and do nothing else. Appendix F in- 
cludes some notes on compiling the various programs in this 
book. In case you're having trouble with your compiler, that 
appendix also includes complete instructions on how to com- 
pile hello. c. (Usually the filenames for source code of C pro- 
grams are given a .c extender.) 

Program 1-1. hello.c 



/* 

* htllo world 

= include <stdio.h> 

maini) 
( 

printf ("HETTO WORID!\n") ; 

) 



One Final Note 

Since it's not possible to cover every aspect of C program- 
ming, some things just have to be learned though experience 
and by making mistakes. Thus, it's important that you do all 
the examples. This book won't discuss everything there is to 
know about C. Only those aspects of C which are important 1 
graphics programming are covered. By the time you're fin- 
ished, though, you'll know enough C that learning the rest 
will be easy. 
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Although all of the discussions of graphics and C pro- 
ture of computer graphics prevems uu 

programming languages. 
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this means and dive right in. But what about someone who's 
never kneaded before? To our naive chef, the term knead re- 
quires more explanation. Knead refers to a whole series of op- 
erations which must be performed on the bread dough. Knead 
is cooking shorthand, so that the recipe writers (the program- 
mers) don't have to include all of the details every time they 
mean Knead the dough. 

For programming a computer, functions are used much 
the same way. For example, the square root function is really a 
set of operations which are performed on a number. When 
you press the square root key on your calculator, it doesn't 
magically generate the square root of the number. Instead, it 
plods through a simple program of its own which calculates 
the square root. Square root to the calculator is like knead to 
the chef. When we press the square root key, the calculator 
runs through the square root function. When we say knead to 
a chef, he says, "Oh, this means I do such-and-such." 

Machine Dependencies 

Abbreviating and simplifying programs aren't the only reasons 
functions are used. Let's return to the analogy. Another step in 
the recipe might be "Measure out two cups of flour." The 
function measure doesn't say how to do the measuring; the 
idea is just to get two cups of flour. The instructions have to 
be vague since everyone keeps their flour in a different place 
and everyone uses different measuring cups. We might say 
that the measure function transcends kitchen dependencies. It 
becomes the task of the chef to figure out where the flour and 
measuring utensils are kept; the recipe doesn't care how it 
happens, just as long as you get two cups of flour. Notice that 
the recipe writer (programmer) doesn't need to understand the 
problems involved in measuring two cups of flour. This lets 
the writer treat the measure function as a black box. When we 
use a black box function, we just give it some arguments, and 
it produces results. We don't care what happens between the 
two, as long as it works. 

Many C functions can be treated as black boxes. They 
help eliminate machine dependencies; it's the entire concept 
behind the graphics library included with this book. For ex- 
ample, the graphics library provides a function to draw a point 
on the screen. When we use this function, we don't care how- 
it draws the dot, just that it does. To you (as a programmer) 
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the function is the same regardless of the computer you re 
using. What actually happens inside the computer might diiler 
greatly from machine to machine. The "Draw a point on the 
screen" function abstracts the differences in the computer s 
operating system and hardware, allowing many computers to 
use the same general programs. , , 

Functions which shield us from the implementational de- 
tails are called portable or compatible functions. C is full ot 
such functions. Most C compilers try to conform to one stan- 
dard set of portable functions. There are several standards, 
most based on various implementations of the UNIX Operat- 
ing System. These "standards" overlap a great deal. Usually C 
programs using portable functions may be moved from one 
computer to another without any significant problems. 

You can see how using functions can save a lot of work, ah 
that's necessary is to find a function which does what you want 
to do, pass it the right values, and enjoy the results Further- 
more, functions allow programs to transcend the differences of 
the computer's hardware and operating system. 

The Essentials of a C Program: main( ) 

All programs written in C must include a mainO function 
which is called when the program first begins to execute. 
When the mainO function ends, the program ends ^ 
names of functions must be unique, so only one mainO func- 
tion per program is permitted. Look again at the hello.c ex- 
ample in Chapter 1. Programs have the basic form: 

/• 

* programmers notes 

• (not compiled) 

*/ 

'include <somesnch> 
mainC ") 

{ 

..program code.. 

} 

All of the text between the /• and •/ consists of comments; 
thev're ignored by the compiler. You can put comments any- 
where in the program. They're used to make the program eas- 
ier to understand. You should always use plenty of comments; 
it makes the code easier to read and less confusing when you 
go back to it later. Blank lines and indenting are also ignored 
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by the compiler; they just make it easier for you to understand 
the program. 

The 'include is a preprocessor directive which tells the 
preprocessor part of the compile process to include the text of 
the file named in the angle brackets (the , > pair) as part of 
the program. As its name implies, the preprocessor is some- 
thing which sorts through the source code before the compiler 
starts doing the real work. We'll explain more about the pre- 
processor in a later chapter. 

The line mainC ) declares the function. It tells the com- 
piler that everything between the first and last braces ( { and 
} ) defines what the function mainO should do. All of the 
text between the braces is called the body of the function. 
When you run your program, all that's really happening is 
that the computer is executing the function mainC ). Thus, ev- 
ery C program has to have a function called main( ). If it 
doesn't, you won't be able to run the program. (You'll proba- 
bly get an error from the linker like "unresolved external ref- 
erence _main". All that means is that the compiler can't find 
the function mainC ) in your program.) 

A word of warning: Unlike most programming languages, 
C is case-sensitive; mainC ) is not the same as MAIN( ), 
Main( ), or mAiN( ). Other languages like Pascal and BASIC 
don't make this kind of distinction; you'll have to keep a spe- 
cial eye out for this mistake if you've programmed in one of 
these other languages. 

mainO is the only function which must be defined in 
your program. Usually you'll be able to name functions any- 
thing you want. By convention the names of C functions are 
all in lowercase letters. 

Using C Functions: printf( ) 

The body of mainC) for hello. c (Program 1-1) has one com- 
mand in it: a printfC ). printfC ) is a very powerful function 
which can format and print text to any output device — the 
screen, the printer, or even a file, hello. c uses it in one of the 
simpfest ways, to print some text to the screen. We've given it 
only one argument, a string. A string is simply a sequence of 
characters. 
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The message in the printfC) is "HELLO WOHLD!\n". 

The quotes aren't part of the string; they serve to mark the 
string's beginning and ending within the source code. The 
argument itself is enclosed by the O which come after the 
name of the function. These serve to delimit the arguments 
being passed to the function. In this case, there is only one 
argument, the string "HELLO WORLD! \n". 

The Backslash Escape 

You probably noticed something strange going on with 
printfC). When we printed the string "HELLO WOULD! \n" 

we got the output HELLO WORLD!. Where's the \n ? It's not 
in the output, or is it? The \ is called an escape character. It 
tells the compiler that the next character is some kind of code, 
and should not be interpreted as a normal character. When the 
compiler sees \n, it knows to insert a new-line character. The 
new-line character starts output on the next line of the screen. 
Beware: printfC ) doesn't advance to the next line automati- 
cally like the BASIC PRINT statement, or the Pascal writelnC ) 
function. We have to tell printfC ) that we want to be on the 
next line with the \n escape sequence. There are other legal 
escape sequences: \t is tab, \to is a backspace, and \ \ is the 
\ character. Try changing hello.c and see what other special 
characters you can find; there are some examples below to 
help get you started. 

printfC" \ n \ n \ nHi there \ n \ n \ n \ n \ n"); 

printf C"T \ nH \ ni \ us \ n \ ni \ ns \ n \ nl \ ne \ ng \ na \ nl \ n")} 

printfC" \ t \ttaobing!! \ n"); 
printfC'and \ n \ tthis \ n \ t \ ttoo \ n")i 
printfO'strings have \ '"s around them"); 
printfC'The escape character is \ V); 
printfC'special characters ,/\ \l"\";\n")i 

Escape sequences you may find useful at times follow. 



Escape Character Result ASCII Value 

\b Backspace 8 

\f Formfeed 12 

\n Newline 10 

\r Carriage Return 13 

\t Tab 9 

\ v Vertical Tab 1 1 

\Cnumber) Octal Value Onnn 
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Writing Your Own C Functions; Declaring 
show_val( ) 

The first function we'll declare is a simple example: a function 
which takes a single argument, and returns no value. We'll 
call this function show_valC ) and print the value of an inte- 
ger on the screen. printfC ) can do all of the hard work for us: 

show-valCx) int x; 

{ 

priatfC"%d", x); 
priat£C"\n")j 

} 

show_valC ) looks a lot like the declaration of xnainO in 
hello. c, but there are a few new features. Let's look at the first 
two lines. show_val says that we're going to name the func- 
tion show-val. Most compilers put a limit on the number of 
characters which must be unique in a name (the number of sig- 
nificant characters). The C language definition says that the limit 
should be eight characters. This means that openfilehandleQ 
would be Ihe same as openfilewliateverC ), since the com- 
piler would only look at the first eight letters. Most compilers 
extend that range; in fact, some look at the first 31 characters. 
Only alphanumeric characters— letters and numbers — and the 
_ character are permitted in the name of a function. The first 
character in a name must be a letter or the _ character. Thus 
"Greetings", "funcl_as", "-hi", and "alfdf" are all legal 
function names, "lgds", "a$hello", and "as.ad,fd" are not ac- 
ceptable names for functions.. 

The x between the parentheses tells the compiler that we 
have one argument which is referred to as x while we're in- 
side the function. The same naming conventions apply to the 
names of yariables. Only letters, numbers, and the _ can be 
used, and he first character cannot be a number. Usually lower- 
case letters are used for variable names. 

When we call show_valC ) we don't have to use an argu- 
ment called x; x is just the argument's pseudonym while 
we're inside the body of the function. We didn't even have to 
use x; its name was arbitrary. We could have used any 
name— "arg" or "steven." This name, x, doesn't have any 
meaning outside of this function. In other words, if we had 
another function with an argument called x, the two would be 
distinct. Variables used as arguments to a function only have 
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meaning within their respective functions. These concepts con- 
cerning variables will become clearer later. A variable declared 
to define the arguments to a function is called a formal param- 
eter. Notice that there's no semicolon at the end of this line. 
The use of semicolons will be explained later. 

The following line, int x; , tells the compiler that the 
variable x is an integer type (in C, integer is abbreviated to 
int). This defines how x should be treated inside the function. 
In other words, we're telling the function what kind of argu- 
ment it is receiving. An int is only one of several different 
types of variables which are supported by C. The next chapter 
will discuss the others. For now, treat an integer as a whole 
number. Unfortunately an integer's largest and smallest values 
are determined by the machines being used, and not by the C 
language. Generally it's safe to use integer variables in the 
range -32767 to 32767. 

The Body of show_val( ); printf( ) and the Percent 
Escape 

The commands in a C program are executed from left to right 
and from top to bottom. Thus the printfC"%d", ±) is executed 
first, followed by the printfC" \n"> The semicolons (;) serve 
to terminate each command. C programmers refer to the com- 
mands as statements. 

The first printfC ) is being passed two arguments. The 
first argument is the string "%d", and the second argument is 
the variable x. "%d" is the formatting string, and the value 
stored in x is the number which is being printed. Note that ar- 
guments are separated by commas. The % symbol is a conver- 
sion specification which indicates where the argument is to be 
substituted, and in what form it is to be printed. "%d" tells 
printfC ) to print the argument as a decimal number. We 
could have used "%x" or "%o", which would print the num- 
ber in hexadecimal (base 16) or octal (base 8) respectively. 
Other conversion specifications are also possible and will be 
covered later. 

We could have combined the two printfC )s as 

printfC"%d\n", x); 

This prints the value of x followed by a new-line character. 
We could add even more textual material to the format string: 
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printfC'The number %d was passed into 
sncw_valC ). \ a", x); 

This is the same as saying: 

priatfC'The number "); 
priatfC"%d", x); 

priatfC" was passed into show_valC ). \ n"); 

printfC ) is not part of the C language; there is no input 
or cutput defined in C. printfC ) is simply a useful function 
which is part of the standard library of routines (stdio.h) that 
are usually included with a compiler and are available to C 
programs. printfC) is different from most C functions in that 
it can take a variable number of arguments. Most functions 
can only take a set number of arguments. With printfC ) we 
pass the number of arguments needed to accomplish the de- 
sired result. When we're printing out the value of one integer 
variible, we need to pass printfC) two things, a formatting 
strirg and the value to print. 

Program 2-1 is a simple program which shows you how 
to call the function show_valC ). We pass show_val( ) the 
number 4, so it will print: The number 4 was passed into 
sb.ov_valC ) to the screen. 

Program 2-1. Calling show_val( ) 

((include <stdio.h> 



main() 



show_val(4) ; 



showjvil (x) 
int x; 



printf ("The number %d was passed into showjval ( ) . \n" , x) ; 
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Programmers using the ST without a command line inter- 
preter are faced with a small problem. Most of the programs 
don't wait for you to press a key when they exit. When run 
from the GEM desktop, the program prints its output and then 
returns to the desktop. This means the output flashes on the 
screen briefly, and is cleared in order to redraw the desktop. If 
you don't have a command line interpreter, we suggest that 
you add the following lines to the end of the programs (just 
before the last closing curly brace at the end of mainO): 

printfC'Press RETURN to exit:"); 
getcharC ); 

Another Example: sub.c and sub( ) 

Here's a function that takes two arguments and returns their 
difference: 

int subCnuml, num2) 
int numl; 
int numS; 

{ 

int subtr; 

subtr = numl - numS; 
return subtr; 

} 

It's not really that much more complicated than 
show. valC ). The sub in the first line tells the compiler that 
the function is called sub. The int in front of the sub says 
that the function is going to return an integer. We didn't de- 
clare show— valC ) with a type since it wasn't going to return a 
value. The numl, numS inside the parentheses indicates that 
subC ) takes two arguments — the first called numl and the 
second num.2. The next two lines define numl and numS as 
integers. We could have used int numl, numS rather than 
the two lines shown. 

The first line of this function, int subtr; , looks familiar. 
It's declaring the subtr variable as an integer. In this case, it's 
not just saying what type of variable subtr is; it's also making 
room for storing it in memory. This is an example of an auto 
variable. In a nutshell, this means that as we enter and leave 
the function, the variable is created and destroyed. Thus, out- 
side the function subC ), subtr has no meaning, and if we call 
subC ) again, the value in subtr probably won't be what it 
was when we last were in the function. We'll discuss more 
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about auto variables later. Notice that the formal parameters 
are defined outside the first brace, while auto variables are de- 
clared in the body of the function. 

In the next line, numS is subtracted from numl and the 
result is stored in subtr We then return the value stored in 
subtr to vhatever called subC ). You might have noticed that 
we didn't put a return at the end of the sb.ow_valC ) func- 
tion. It's rot really necessary since there is an implied return 
at the end of the function (at the last } ). 

Program 2-2 is a short program which uses the subC ) 
function. Remember, the line "include <stdio.h> is a prepro- 
cessor command which includes the file stdio.n in your pro- 
gram. This is needed if you use the standard C library 
functions ike printfC ) . You'd probably never use subC ) in a 
real prognm since you could just use - instead (as is done in- 
side subO). It does show how a function like subO might be 
used. 

Program 2-2. sub.c 



/* 

* simple program which uses sub() 
V 

/* 

* include srdio.h because we're using printf () 
V 

jjinclude <staio.h> 
/* 

* define sub() so the compiler knows that it is returning 

* an int. totice that we aren't saying WHAT sub() does, we're 

* just telling the compiler that sub() returns an int. In addition 

* we don't actually declare sub() until after the declaration of main(). 
*/ 

extern int sjb() ; 
/* 

* declaration of main() . This is the function which the computer 

* will execute first once it starts working on our program 

V 
main() 

( 

int a=5; 
int b,c; 

b = 8,- 

c = sub(a,b) ; 

printf("The result of %d minus %d is %d\n",a,b,c) ; 

) 

/* 

* the ) abc/e is the end of main() . This is where the program 

* execution will stop. 
*/ 
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* below is the declaration of sub(). We've already told the compiler 

* that sub() returns an int, but we have to tell it again here, 

* so that it knows we're being consistent. 

V 

int sub (numl, num2) 
int numl; 
int num2; 

( 

int subtr; 

subtr = numl - num2; 
return subtr; 

} 

Programmers using the ST without a command line inter- 
preter should add the following lines just before the last clos- 
ing curly brace at the end of main( ) 

printfC'Press RBTXTKXf to exit:"); 
getcharC ); 

extern, extern (short for external) tells the compiler that 
we are going to define something, but not declare it. (There is 
a difference between define and declare. When we define 
something we're just saying how it should be treated. When 
we declare it, we're actually reserving space in memory for it 
or saying precisely what it does.) What we're defining here, 
int subC ), is actually declared somewhere else (hence the 
command's name, extern). The definition is necessary in or- 
der for the program to compile correctly. We're telling the 
compiler that the function subC ) returns an int . 

Function arguments. When we use subC ), the order of 
the arguments is important. The way we've used subC }, 
numl will hold the value of a, and num8 will hold the value 
of b. There is a one-to-one correspondence between the order 
of the arguments in the function's declaration and when each 
is used. 

Look at the line containing printfC ). The formatting 
string has three %d's in it, one for each of the arguments that 
follow. Each of the %d's is filled, first come, first served. The 
output of sub.c looks like: The result of 8 minus 8 is —3. 
The order of the arguments is important. But there's more to it 
than that. C compilers usually don't check that you're passing 
the right number of arguments. In other words, you could 
code printfC"%d") and the compiler wouldn't bat an eye. 
printfC ) would be a mite confused, as you didn't give it a 
value to print. 
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The mechanics of how the parameters are passed into the 
function are not important to us as C programmers. What is 
important is that the function is given its own working copies 
of 1he variables. Thus subO can change the value of numl 
without affecting the value of a. This means that the argu- 
ments are passed by value, not by reference. We could recode 
suX ) to eliminate the variable subtr. 

snl(numl, numZ) int numl, num2; 

{ 

numl =numl — numS; 
return numl; 

} 

This subC ) is functionally identical to the subC ) function 
above. Remember, changing the value of numl has no effect 
outside sub( ). 

Pre-initialized Auto Variables 

Remember when we talked about subC ) and subtr? We said 
that subtr is an auto variable, a and b are also auto variables. 
Ths helps emphasize the fact that malnC ) is just a function 
like any other C function. In sub.c, we want to give a and b 
initial values. We've used two ways of initializing these vari- 
ables. The first way is used with the variable a. There, we ini- 
tialize it to a value as it's declared. In other words, as soon as 
we make space for it, we assign it a value. 

The other way to pre-initialize an auto variable is used 
with variable b; we assign it a value at the beginning of the 
main function. You can initialize auto variables either way. We 
could have used int a=6, b=8; and left the line b=8 out of 
the body. Or, we could have used int a,b; to declare the vari- 
ables, and then used a=B; b=8; in the program to give them 
their initial values. Use whichever method is clearer. A word 
of warning: The value of any auto variable is undefined until 
it's given some initial value (that is to say, it could hold any 
value until it is initialized). Some compilers (like the Lattice C 
compiler) will complain if auto variables are not initialized 
before they are used. 

Expressions as Arguments 

Yon probably would never write a program which uses subC ) 
as i function, since you can always use subtraction, ( — )• Pro- 
gram 2-3 shows just how this can be done. Notice how the ex- 
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pression a-b can be used as an argument to a function. When 
we talked about subC ), we said that all of the arguments are 
passed to the function by value, not by reference. printfC ) is 
a function just like subC ), so its arguments are also passed by 
value. This means that the expression a— b is evaluated to a 
single value and that value is passed to printfC ). Even the 
most complex expression can be the argument to a function. 
As you can see from newsub.c, this can eliminate a number 
of temporary variables. 

Program 2-3. newsub.c 

/* 

* another simple program which eliminates sub() 

* notice that the temporary variable c was also eliminated 
*/ 

^include <stdio.h> 

main() 

( 

int a=5, b=8; 

^ printf ("The result of %d minus %d is %d\n",a,b,a-b) ; 

Programmers using the ST without a command line inter- 
preter should add the following lines to the end of the pro- 
gram (just before the last closing curly brace at the end of 
mainC )): 

printfC'Press RETURN to exit:"); 
getcharC )> 

Sample Program: figs.c 

The last example program in this chapter makes heavy use of 
functions and has been designed to demonstrate the graphics 
library. It draws three overlapping figures on the screen: a 
square, a triangle, and a five-pointed star. The program uses 
six different graphics functions. Notice that we have to put the 
line 

'include "machine.n" 

in the program. This inserts the file mach.ine.n in the source 
code. This is necessary because you're going to use the graph- 
ics library. This is a little different from the other 'include, 
which reads: 

"include <stdio.n> 
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With machine.h, we use double quotes, but with 
stdio.h, we use angle brackets. The exact interpretation of 
double quotes and brackets varies from compiler to compiler. 
Generally, if you use double quotes with 'include, the com- 
piler tries to find the include file in the directory which holds 
the source code. The angle brackets usually mean that the 
compiler is to search the include path instead. The include 
path is generally specified as an environment variable or as a 
command line argument when you run the compiler. Often, 
one puts the system include files (like stdio.h) in one direc- 
tory, and irclude files which are specific to one program or 
project in another. This helps keep them separate. 

When the figs.c first starts, the function init_graphicsC ) 
is called. TMs does whatever is necessary to set up the screen 
for the particular computer you're using. init_graphics( ) 
takes one parameter: either COLORS or GREYS COLORS tells 
init-grapMcsC ) that you want to work with a color screen. 
GREYS says that you want to use grey shades. On the Atari 
monochrome screen, the "colors" are simulated with patterned 
lines. Each color has a different broken-line pattern. 

COLORS and GREYS are preprocessor definitions. All pre- 
processor commands must be on their own line, and must be- 
gin with a *. Basically, the 'define command does simple text 
substitution. If used as follows: 

'define LINBLENGTH 188 

every time the text LINELBNGTH is in the program, the text 
128 is substituted. This makes self-documenting code very 
easy to write. All of the program's arbitrary constants (like the 
resolution of the computer's display) can be defined like 
LINBLENGTH. This has two advantages over using the num- 
ber directly: It's clearer where the number came from, and it 
makes the program much easier to change. If you're careful 
about the way you use defined constants, modifying a pro- 
gram's arbitrary constants is no harder than finding the right 
definition and changing it. These simple text substitutions 
make the programs more easily portable from computer to 
computer and compiler to compiler. We've also used them to 
simplify the graphics routines. COLORS and GREYS are a lot 
easier to remember than 0 for colors and 1 for grey shades. 
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Next, we draw a square on the screen. Depending on 
which computer you're using, it might look more like a rectan- 
gle than a square. We decided to draw the square ir i green so 
we call the function set-penC) with the color M™J here 
are eight predefined colors you can use: BLA CK,^^' 
RED, GREEN, BLUB, CYAN, YELLOW, and MAGENTA. You 
must call init-graphicsO with COLORS for this to work. 

The box is drawn using a combination of the moveC 3 ana 
drawO functions. moveO takes two arguments, the x and y 
position, to move to. Thus: 
move(x,y); 

changes the current position to C*,y). It doesn't draw anything 
on the screen. O>,0> is in the upper left-hand corner of the 
screen, with increasing x to the right, and increasing y down- 
ward, x can range from 0 to Cx-size - l) and y can range 
from 0 to Cy-si« - D- x_size and y_size are integers whose 
values are set during init-graphicsO; m machine.n, they re 
defined as extern int. 

Figure 2-1. x and y Coordinates of a Typical Computer 
Screen. 



(x-size — 1) 




• (30,10) 



(y-size— 1) — 



drawC ) also takes two parameters, x and y, but rather 
than simply move to (x,y), drawO draws a line from the cur- 
rent position to the position you've specified. That position be- 
comes the current position for the next call to drawO You 
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must use drawC ) and moveC ) together to draw lines on the 
screen. Thus: 

moveC10,10); 
drawC100,100); 

draws a diagonal line from 0-0,10) to C100,100) in whatever 
color is specified in set_penC ). Don't try to draw lines outside 
the boundaries of the screen. That will probably crash the 
computer. 

This same drawC ) and moveC ) procedure is used as a tri- 
angle and star are drawn. 

When you've finished using the graphics screen and are 
ready to exit from your application, call exit_graphicsC ) 
before leaving the program. exit_graphicsC ) "undoes" what 
init-grapHicsC ) did. It takes one argument, a string which 
can hold some message to print out. If you don't want to in- 
clude a message, pass exit-graphicsC ) the value NULL. 
NULL is defined in stdio.h. If you use NULL, you include 
stdLo.lt: 

'include <stdio.h> 

(Note: If you're using the Alcyon C compiler for the Atari, 
NULL hasn't been defined in stdio.H. A definition for NULL 
is included in the version of machine.h for the Alcyon com- 
piler.) Thus: 

init-graplxicsCORBYS); 
exit_graphiC8Cinri.L); 

initializes and then leaves the graphics environment. 

A final word of warning: Don't call exit-graphicsC ) 
without first calling init-grapfeicsC ), and don't call any 
graphics routine without first calling init-graphicsC )■ Doing 
things out of order can cause trouble for the computer. 

If you need help compiling the program, please refer to 
Appendix F. Remember that figs.c must be linked to the 
graphics library for it to work properly. This is explained in 
Appendix F also. Appendix G explains all of the graphics 
routines, and the appendices I and J explain how the graphics 
routines work. 
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7 * figs.c - demonstrate the use of function calls to the graphics library. 

* draw three overlapping figures on the screen, a green square, a 

* blue triangle, and a yellow five-pointed star. 

*/ 

7 * include these files so we get sane definitions we need for 

* this to compile correctly 
V 

# include <stdio.h> 
((include "machine.h" 

main() 

( 

7 * initialize the graphics routines; imt_graphics() sets up a 

* new graphics screen to draw on. Tnis keeps the text and graphics 

* separate from one another. 
*/ 

init_graphics(COI£)RS) ; 

X * draw the square; the (SHORT) is called a "type cast". They -11 

* be discussed later. Whenever you use set_pen, however, you have 

* to put the (SHORT) before the argument. 

set pen ((SHORT) GREEN) ; /* draw it m green / 
irovi(10,10); /* starting point V 

draw(100,10) ; /* go right 90 pixels V 

draw(100,100) ; /* go down / 

draw (10, 100); /* go left / 

draw(10,10) ; /* return to where we started */ 

/* 

* draw a triangle 
V 

set_pen( (SHORT) 
move (75, 75) ; 
draw(150,175) ; 
draw(0,175) ; 
draw (75, 75) ; 

/* 

* draw a star 
*/ 

set_pen( (SHORT) YELLOW) ;/* star will be yellow 
move(300,125) ; 
draw(119,159) ; 
draw(231,5) ; 
draw(231,195) ; 
draw(119,41) ; 
draw(300,125) ; 

7 * leave the graphics routines — exit_graphics ( ) will prompt to 

* let the user look at the figure that's just been drawn. 
V 

exit_graphics (NULL) ; 

) 



BLUE) ; /* draw this figure in blue */ 

/* start at the peak */ 

/* draw one leg */ 

/* draw the other leg */ 

/* complete the figure */ 



V 
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Programmers using the ST without a command line inter- 
preter should add the following lines to the program (just 
before tie exit_graphicsO function at the end of mainC)): 

printfCPress HETTJBH to exit:"); 
getcharC ); 




bO I3.r, we've only talked about the integer variable 
type. Even though integer variables are very versatile, you 
can't do everything with them. It wouldn't be easy to work 
with angles or fractional numbers, for example. C has four 
basic data types: characters, floating-point numbers, double- 
precision floating-point, and integers. These go under the 
names of cbar, float, double, and int, respectively. 



Characters 

A char is a single character, like the letter a or the symbol *. 
\n is also a single character (new-line), and it can be assigned 
to a variable of type char. In Chapter 2, we said that there are 
a number of these backslash escape characters. These let you 
work with characters which would be very difficult to deal 
with otherwise. Unfortunately, there isn't a backslash escape 
for every nonprintable character. If you want to print a charac- 
ter which doesn't have a backslash escape (for example, char- 
acter 27, ESC) you can follow a backslash with a three-digit 
octal number. Thus \ Oil is character 9 (a ctrl-I) and \033 is 
character 27 (ESC). For all of the compilers, a char is an eight- 
bit number, a single byte. If you're at a loss about bits and 
bytes, you should probably read Appendix C. When you need 
to specify a char to the compiler, you surround the character 
in single quotes ( ' ), not double quotes. Only strings are sur- 
rounded by double quotes. This distinction is important, and 
will be explained in more detail later. 



Floating Point 

Another variable is the type float, which stands for floating 
point. Floating-point numbers are numbers which may have a 
fractional part (similiar to the type real in Pascal, or a normal 
variable in BASIC). There is another type of float called a 
double. Type float is a single-precision floating-point num- 
ber, while double is a double-precision floating-point number, 
double is just a larger, more precise version of a float. To 
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specify a floating-point constant, you just include a decimal 
point. For example, 3.0 is the floating-point representation of 
the number 3. The compiler makes a distinction between 3.0 
an d 3— the first is in floating-point notation and will be 
treated as a float, while 3 is an integer. This distinction 
usually isn't that important since the compiler readily converts 
from one :ype to another, but there are times when it can be 
crucial. Beyond the more typical floating-point numbers we ve 
mentioned so far (like 3.4, or 13.43), you can also specify a 
floating-point number which has a power-of-ten exponent as- 
sociated vrith it. People often say that such numbers are repre- 
sented in scientific notation. In C, the following notation is 
often acceptable: x.xxe+xx. For example: 2.3e + 2 is 230; 
6.2324e-J is 0.0062324. 

Lntegers 

As was stated above, the exact size of an int type is not speci- 
fied by the C language definition. The int type is the most 
convenient size that the host computer can handle. On most 
typical 68000-based microprocessors, variables of type int 
usually cen contain values in the range -32767 to 32767. By 
definition, int is the length of a machine word. Type int is 
used as a kind of C language default— C will assume that 
everything is an int unless it's told otherwise. Thus, all func- 
tions are assumed to return an int, all variables are assumed 
to be int, and all numeric constants are int. 

Havhg a default type has a number of useful conse- 
quences. In sum.c, for example, there was no reason to use 
the extern to define sumO (remember, we said that the com- 
piler needed to know what sum() returned). If we'd left the 
extern out, the C compiler would have first encountered 
sumO inside the printfO- There, it would have made the 
assumption that sumC ) returns an integer. In other words we 
didn't have to tell it explicitly that snmO returns an int. It 
would have figured it out by itself. You cannot do the same 
thing with variables— you can't just use a variable without de- 
claring it The C compiler will display an error message when 
it encounters an undefined variable. Not only have you not 
told the compiler what type the variable is, but you haven t 
told it where to make space for the variable in memory. Irms, 
functions which return ints need not be defined, while vari- 
ables always have to be defined and declared. 
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The remaining qualifier is register. Any variable with the 
qualifier register will be stored in a register of the processor 
rather than in the computer's memory. This allows for faster 
access to that variable. In practice, the actual interpretation of 
this qualifier is left to the particular compiler being used. 
Sorre compilers ignore all references to register, while others 
actually try to use processor registers if they are available. 
Sorre compilers, though none of the ones we've used here, 
will use registers even if they're not declared as register vari- 
ables. You'll have to consult the documentation that came 
with your compiler to find out precisely how your compiler 
deals with register variables. Placing heavily used local vari- 
ables into registers often improves performance, but in some 
cases, declaring a register variable may degrade performance 
somewhat. In any event, judicious use of the register quali- 
fier may improve your program's performance when you are 
using a compiler which supports register variables. Some of 
the urograms in the later chapters will make extensive use of 
declaration register int. 

Putting all of these together can often be tricky. It's sim- 
ple, just as long as you apply the qualifiers one by one. Here 
are iome examples: 

unsigned long int a; 
short int b; 

register unsigned, long c; 
unsigned short d; 
register unsigned int e; 
short f; 
unsigned g; 

All of these are valid variable declarations. Can you pick 
out he two variables which are identical? Which of the vari- 
able; are the same size? (b and f are identical, while a and c, e 
and g, and b and d are merely the same size). 

Table 3-1 lists the different variable sizes for the five com- 
pileis supported by this text. Given is the number of bits allo- 
cated for a variable of that type. 

Table 3-2 lists the number of significant characters in a 
function or variable name, as well as the number of register 
variibles each compiler supports. Data registers are registers 
whi<h can be used for ints and chars. Addressing registers are 
for jointers (we'll talk about pointers in Chapter 5). 



34 



Variables, Operators, and Expressions' ' : 



Table 3-1. Compiler Information 
int 





normal 


long 


short 


float 


double 


char 


Atari ST 












Alcyon 


16 


32 


16 


32 


64 


8 


Lattice 


32 


32 


16 


32 


64 


8 


Megamax 


16 


32 


8 


32 


64 


8 


Amiga 














Aztec 


16 


32 


16 


32 


64 


8 


Lattice 


32 


32 


16 


32 


64 


8 



Table 3-2. Other Compiler-Dependent Information 





significant 




registers 




characters 


data 


addressing 


Atari ST 








Alcyon 


7 


5 


3 


Lattice 


8 


4 


4 


Megamax 


10 


4 


2 


Amiga 








Aztec 


31 


4 


2 


Lattice 


31 


6 


4 



Declaring Variables 

Remember, auto variables are variables which appear when 
you enter a function, and are destroyed when you leave it. 
These facts have some important consequences. You won't 
know what value an auto variable is going to have when you 
first enter the function; hence it is important to initialize all of 
the variables before you get started with the real work. In 
Chapter 2 we discussed a variety of ways to initialize auto 
variables. 

Probably of greater significance is the fact that the vari- 
ables are destroyed when you leave the function, since you 
have no way of retaining values that the function might need 
the next time it is used. For example, let's think about a rou- 
tine which writes characters to the screen. Among other 
things, it needs to know the position of the cursor. We could 
pass the position of the cursor as two arguments (row and col- 
umn) whenever we wanted to write a letter, but that would be 
cumbersome. After all, we don't really care where the cursor 
is; we just want the letter on the screen. The simplest solution 
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is to have the "write character" function itself "remember" 
where the cursor is and change the position of the cursor in- 
ternally. This obviously can't be done with auto variables, 
since they are destroyed when we leave the function. Local 
variables which "stick around" after the function has been 
called are needed. There are two solutions to this problem. 
The first is to add the qualifier static to the variable. 

Static Variables 

When we talk about static variables we are using the word 
static in the sense of stationary and not dynamic. For example, 
static electricity is electricity that isn't flowing. Using the 
static qualifier means that the variables won't be created and 
destroyed each time the function is called. Instead, they will 
only be created once and will "stick around" after we leave 
the function. They won't lose their values like auto variables. 
The qualifier static is used just like any of the other qualifiers 
we've talked about (long, snort, register, and so on), static 
may be used with any type of variable. 

static variables are treated exactly like auto variables ex- 
cept that a static variable is only created once. When a func- 
tion declares a static variable: 

somesuchO { 

static int a; 
/• misc. code •/ 

} 

the int a can only be used inside the function somesuchC ). It 
won't be defined outside somesuchC ) and you won't be able 
to get at its value. This is just like auto variables declared in- 
side functions. However, a retains its value each time the 
function is called. If the variable a is incremented by the code, 
the next time the function is called, a will contain the new 
value. 

Global Variables 

The other solution to the problem of a permanent variable is 
to use a global variable. Program 3-1 uses global variables. 
There are lour functions: funcaC ), funcbC ), funccC ), and, of 
course, malnC ). Notice how the global variable abc is de- 
clared. In form it's just like the auto variables you're familiar 
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with; it's the position of this variable declaration that's new. 
abc is declared outside all of the functions, but it is defined for 
any of them. Thus we can use abc inside main( ), funcaC ), 
funcbC ), or funccC ), and we'll always be using the same int 
abc. 

Program 3-1. global.c 

/* 

* program to help demonstrate the scope of variables 
V 

int abc; /* global variable */ 

mainO 

float jk; /* to main() */ 

abc = 12; /* global to program */ 

jk = 3.1415; /* local to main() */ 

printf ("main: abc: %d, jk: %f\n",abc, jk) ; 
funcaO ; 

printf ("main: abc: %d, jk: %f\n",abc, jk) ; 
funcb() i 

printf ("main: abc: %d, jk: %f\n",abc, jk) ; 
funcc() ; 

printf ("main: abc: %d, jk: %f\n",abc, jk) ; 

) 

funca() 

float abc; /* local to funca() */ 

abc = 2.7; /* local to funca() */ 

printf ("funca(): abc: %f\n",abc); 

) 

funcb() 

static int jk; /* local, but static */ 

abc = 23; /* global change */ 

jk = 43; /* local change */ 

printf ("funcb() : abc: %d, jk: %d\n", abc, jk) ; 

} 

funcc() 

abc =12; /* global change '*/ 

printf ("funcc(): abc: %d\n",abc); 

) 



Programmers using the ST without a command line inter- 
preter should add the following lines just before the last clos- 
ing curly brace at the end of mainC ): 

printfC'Press RETURN to exit:"); 
getcharC ); 
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Be sure to include the line "include <stdio.li>. 

You might already see a problem. We have declared an- 
other variable abc inside funcaC )• How is this conflict dealt 
with? We already have a global int abc; how is the locally de- 
clared float abc dealt with? In cases like this, the local variable 
takes precedence over the global one. Inside funcaC >, abc is 
the locally declared float. This makes it impossible to use the 
globally defined Int abc. The locally defined float abc is just 
like any other auto variable: It will be created and destroyed 
as we enter and leave the function. Remember, the two vari- 
ables, abc, are completely independent of one another. When 
we enter funcaC), the global abc is unimportant to us, since 
we'll be using the local abc instead. 

Mow let's turn to fnncbC }. Here, we've declared jk to be 
an int, but in mainO, we use jk as a float. You might think 
that we have a conflict here as well, but actually we don't. 
The float jk which we declare in mainC ) is completely inde- 
pendent from the int jk we declare in fnncbC > Each is local 
to its own function. So, as far as mainC ) is concerned, the jk 
declared in funcbO doesn't exist. 

In funccC )we have assigned a value to abc. The float abc 
declared in funcaO only has meaning inside fnncaO; thus, 
when we use abc in funccO, we are referring to the globally 
defined abc. Things would have been different if we'd used 
this version as funccC ) instead: 

funccC) { 

int abc; 

abc - 87; 

^ prlntfC'funccO: abc: %d\n",abc); 

Here we're declaring a local abc, and assigning it a value. 
The value of the globally defined abc does not change, and as 
far as anything outside funccC) can tell, nothing has hap- 
pened. All of the action is internal to funccC ) 

There's no clear rule as to whether to use a static variable 
or a global variable. At first it might look easier just to define 
global variables and not worry about using static or auto vari- 
ables at all. All of the variable declarations would be together. 
If you needed to change one, there would be no need to go 
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hunting throughout the program to find it. At the same time, 
it's convenient to have the needed variables with the function 
which is using them. Any function can change the contents of 
a global variable. Sometimes this is good; you might use 
global variables to allow different functions to communicate 
with each other. But this can be very dangerous. Perhaps a 
function changes the value of a global variable when it 
shouldn't or when you don't expect it to. This kind of bug is 
very difficult to track down. In general, it's considered good 
programming style to use as few global variables as possible. 

Review of Variable Types 

There are basically four kinds of variables: 

formal parameters variables which act as arguments to a function 
auto variables local variables which are created and destroyed 

as you enter and leave a function 
static variables local variables which are only created once and 

don't disappear when you leave a function 
global variables variables which can be used and changed in any 

function in the program 

Formal parameters and auto, static, and global variables 
each have their own rules for when a variable is defined and 
when it isn't, and for how long it holds its value. 

Expression Operators 

In Chapter 2, we wrote a simple function called subC ) which 
found the difference of its arguments. C could have been de- 
signed so that all of the mathematical functions were done this 
way. We could have had an add( ) function, a multiply( ) func- 
tion, and so on. There is a language called LISP which acts 
this way, but having C do likewise would have made it very 
difficult to use. So instead of functions being used, all of the 
simple mathematical functions are implemented as operators. 
An operator is just a symbol which means do something. For 
example, the + (addition) operator means "Find the sum of 
the expressions on either side of the symbol." So "2 + 4" 
means "Find the sum of 2 and 4." 

C offers a plethora of operators. Operators could be orga- 
nized by the number of operands they take (an operand is to 
an operator what an argument is to a function). There are 
unary operators (operators which take one operand), binary 
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operators (two operands), and trinary operators (three 
operands). However, we have chosen to organize the oper- 
ators by what they do. There are arithmetic operators, bitwise 
operators, bgic operators, address operators, and the condi- 
tional operator. 

Arithmetic Operators 

You're probably well aware of the more familiar arithmetic 
operators: 

+ addition 
— subtraction 
* multiplication 
/ division 

These are all binary operators; they require two operands to 
make sense. When you work with integer math, division ig- 
nores any remainder; for instance, 10/3 is 3. The remainder, 
1 /3, is ignored. The - (negation) operator (such as is used to 
change the sign of a number) is an example of a unary oper- 
ator: When you use negation, you only need one operand, the 
number you're negating. 

There is another operator related to division which hasn't 
been mentioned. It's called modulus. Its symbol is %. The mod- 
ulus operator calculates the remainder of the division rather 
than the quotient. For example, 19/7 will produce a result of 
2, but there is also a remainder of 5. Five is the result calcu- 
lated by modulus division ( 19 % 7 is 5). The % operator is 
usually pronounced "mod," as in "19 mod 7 is 5." 

Introduction to Expressions 

Operators are like verbs in English: They indicate what kind 
of action is taking place. In English, we put nouns and verbs 
together to make sentences. In C, we use operators and vari- 
ables to build expressions. These expressions are evaluated 
down to a single value or action. Let's look at some simple ex- 
pressions end make sure we can evaluate them ourselves: 

8 + 7 /* evaluates to 12 '/ 

4*8 /* 8 */ 

18 / 5 /• S •/ 

89 % 16 /• 13 7 



40 



* Variables, Operators, and Expressions ' 



These are all pretty straightforward; but what happens when 
we start making them more complicated? 

8 + 34+18 

This is all right, since it really doesn't matter which way we 
evaluate it. We could work the expression from left to right, or 
Tom right to left. In either case, we'll get the same answer. 
But what about the following? 
8 • 8 + 89 / 16 

There are a number of different ways we can evaluate 
this We could evaluate it from left to right: multiply 5 by 2 to 
SfloTadd 29 to get 39; and divide by 16 to get 2 (remember, 
we're dealing with integer math, which ignores the remam- 
deTch we could group the multiplication and division and 
feave tne^ddition until the end: Multiply 5 by 2 to get 10; di- 
vide 29 by 16 to get 1; and add the result to get 11. C uses 
St latte/approach. The preceding expression is the same as. 

C8'8) + C8»/16) 

To use the first interpretation, it is necessary to group the 
numbers with parentheses this way: 
C 6 * 8 + 89 ) / 16 

Multiplication and division are carried out before addition 
and subtraction. Table 3-3 is a subset of the complete table of 
mathematical precedence used in C. Operators are listed inor- 
Ter ofTeir precedence (from highest to lowest), and associativity. 



Table 3-3. Abbreviated Table of Precedence 




operator 




associativity 


precedence 




negation 


right to left 


highest 


• 

/ 
% 


multiplication 

division 

modulus 


left to right 


* 


+ 


addition 
subtraction 


left to right 






assignment operators 


right to left 


lowest 



To override the default precedence of operators you can 
include parentheses. Operators inside the parentheses are 
evaluated before the operators outside. 
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The column associativity in Table 3-3 indicates the direc- 
tion in which evaluation takes place if all of the operators 
hav< the same precedence. In other words, an expression like 

3-6-8-6 

where all of the operators have the same precedence, is evalu- 
ated from left to right. Thus, the evaluation looks like this: 

CC3 - 6) - 2) - 6 

C-a - a) - 6 

— B — 6 

-1] 

Program 3-2 is a short sample program which uses some 
of tie concepts developed here. The program gets two num- 
bers from the user (using scanfC )), divides them, and prints 
the result. 

Program 3-2. divide.c 

/* 

' * civide.c — fractional division using integers 
V 

7 * nclude file; we're using printf () and scanf () , so we should 

* cet some of the definitions from stdio.h so the compiler 

* Inows what's going on. 

*/ 

t include <stdio.h> 
maii() 

int divd, /* dividend V 

divs, /* divisor 

quot, /* quotient 



remain; 



/* remainder */ 



* |et the number to be divided using scanf () ; the use of 

* scanf () and the & operator will be discussed later. 
*/ 

printf ("Input the dividend: ") ; 
scanf ("%d", £divd) ; 

/* 

* jet the number to divide by using scanf () 
*/ 

printf ("Input the divisor: ") ; 
scanf ("%d", &divs) ; 

quot = divd / divs; /* calculate the quotient V 

remain = divd % divs; /* and the remainder / 

7 * arint the results using printf () . Notice that we have to 

* ffiep the arguments ordered the same way we want them to 
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* fill in the "%d" escapes. Notice also that we're allowed 

* to break program lines if they get too long to fit 

* on the screen. 

printf ("%d divided by %d is %d %d/%d\n", 
divd, divs, quot, remain, divs); 

} 

Programmers using the ST without * com ™f^ e J* ter ' 
preter should add the following lines at the end of the .pro- 
gram (just before the last closing curly brace at the end of 
mainC )): 

printfC'Press KBTUBST to exit:")? 

getcharC ); 4 

Increment and Decrement 

These arithmetic operators are just the tip of the iceberg when 
it comes to Cs list of operators. There are two other arithmetic 
operators which are somewhat different: increment (++) and 
decrement (— ). These allow you to increase and decrease a 
variable by 1 without having to use an equals sign. Tta is 
called incrementing and decrementing a variable. In terms of 
precedence and associativity, they are identical to negation. 
Using them is easy. Suppose you have an int called fred. 

+ +fred; 

increments fred by 1. Thus if fred initially holds 10, it holds 

U af£r this expression is evaluated. In other words, it's func- 

tionally equivalent to 

fred = fred + 1; 

will subtract 1. So: 

fred; 

is the same as 
fred = fred — 1; 

+ + and can be used on either side of the variable 

thev're working on. If the increment or decrement operator is 
plLd before t § he variable, it is called a prefix operator A .post- 
fix operator is one which is placed after the variable. In both 
cases the result of the operation is incrementing or decrementing 
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the varialle by one. However, the expression ++a will incre- 
ment a before using its value, while a+ + increments a after its 
value has been used. 

a = ++»} 

This statement increments to and then assigns the value of to to 
a. If to eqials 23, what will a hold? We said that to is incre- 
mented before the value is used, whereby to will hold 24, and 
then the lvalue of to will be assigned to a. Thus to and a will 
both hold 24. What do you suppose the following means? 

a = to+4; 

Following the same logic, the value of to is assigned to a, and 
then to is incremented. If to holds 23 before this assignment, b 
leaves holding 24 and a still has 23. Decrement (--) can be 
used in tke same way. 

One word of warning: It's considered a bad programming 
practice to write code which depends on the order of evaluation. 

Assignment 

Although it may not be obvious, - is also an operator, and is 
called tht assignment operator. Clearly, we want the prece- 
dence of - to be very low, so that we don't have to use pa- 
rentheses every time we want to assign a value to a variable. 
In fact, ic the scheme of Table 3-3, the - is at the bottom. Its 
associativity is from right to left. The fact that - is an operator 
has a number of interesting consequences. For example, you 
can assign values to variables this way: 

a — to - c - 8; 

Evaluation of this line is from right to left, so the first 
thing evaluated is c = 8. The value of 5 is assigned to c. to is 
also assigned to 5, as is a. In the end, a, to, and c are all set to 
5. This technique can come in very handy for initializing a 
large number of variables to the same value. 

Theie are even more complex things which can be done. 
For example, this: 
a = 10 *Q> - c + 10 / d); 
is functicnally equivalent to 

b = c + 10 / d; 
a = 10 *to; 
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(Notice that the parentheses surround the assignment of to be- 
cause the precedence of = is lower than that of *, and we 
want the assignment evaluated before the multiplication.) 

There are still more ways that the assignment operator 
can be used. Consider the following: 

a += 10; 

It's functionally equivalent to 
a = a + 10; 

In other words, the + = operator adds the value of the oper- 
and on the right to that of the operand on the left, and stores 
the result in the operand on the left. Thus 

a = 8; /• a lias the initial value of five */ 
a + = 3; /• add three to a •/ 

would result with a holding 8. There are assignment operators 
for each of the binary arithmetic operators; thus -=,•=,/=, 
%-=, and +- are all valid. So, for example, a /- 10 is the 
same as saying a = a/10. In terms of precedence and asso- 
ciativity, these assignment operators are exactly like = . Given 
this, we now have four ways to increment a variable: 

fred = fred + 1; 
+ +fred; 
fred++; 
fred + = 1; 

They all accomplish the same thing, but some are terser than 
others. 

Mixing Floats, Chars, and Ints 

All of the operators we've mentioned so far and the bitwise 
operators (see below) will work with char variables and any 
kind of int variable. If you're using floats or doubles, you can 
only use +,—,*, or /, the arithmetic operators. You're not al- 
lowed to use % with floats. Conceptually, everything is fairly 
straightforward as long as you keep floats with floats and ints 
with ints. 

It's important to understand what is happening before 
you start mixing variables of different types. For example, 
when you divide an int by a float, is the division carried out 
by converting the int to a float and then doing floating-point 
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division, or is the float converted to an int and integral divi- 
sion performed? This can make a difference in the answer. For 
exanple, if the operation: 

28 y 2.6 

is conducted with floating-point division, the result is 10.0. If 
it's Jone with integer division, the 2.5 gets truncated to 2, and 
the result of 25 / 2 is 12. 

C avoids this problem with the following rule. In general, 
if at operator, such as + or -, has two mismatched operands, 
then the operand with the lower type is converted to match 
the operand of the higher type. The result returned is m the 
higler type. 

For each arithmetic operator, the following sequence of 
conversion rules is applied. char and short are converted to 
int and float is converted to double. If either operand is a 
double, then the other is converted to a double and the result 
is a double. If either of the operands is a long, then the other 
is canverted to a long and the result is a long. If either oper- 
anc is unsigned, the other is converted to unsigned and the 
result is unsigned. Otherwise, operands must be int, and the 

result is an int. . , ( 

Conversions take place across assignments; the value ot 
the right side is converted to the type of the left, which is the 
type of the result. A character is converted to an integer. The 
reverse operation, int to cbar, is simple. Any excess high- 
order bits are dropped. 

If an operator has two operands, one a float and another 
an Lnt, the int is converted into a float; then the operation is 
performed and the result is a float. For example: 

10 f 3.0 

resilts in floating-point division, since 3.0 is a float. But 
10 f 3 

results in integer division because both operands are integers. 
C fries to maintain the highest possible precision m its calcula- 
tions. To this end, the Lattice C compiler always converts 
floits to doubles before it does any floating-point math, lhe 
results which are returned are always doubles. This can cause 
problems, so when you're dealing with floats and Lattice L, 
usi caution. 
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Remember, this only takes care of operators like +, , *, 
and XeTato s like * J and ~ (see bitwise operators be- 

fow/requfre ints or chars. They can't be used with floats, 
low) require i also haye their own ru les. For 

them tL opS on the right is converted into the type of 
the Operand on the left before the assignment is made. Sup- 
pose aTs an int, and b is a float in the following example. 

a = b / 4.2; 

will perform floating-point division (b divided by 4 2) and 
Sen convert the result to an int before storing it m a. 

Tvne Casting 

Unfortunately, this business with automatically converting one 
tvne to another is a place where some compilers fail. In some 
2£K "mpoU to insert type-casting £ ex- 

™Pssion This forces the conversion of a variable from one 
C Wrthe . Type-casting operators aren't much to look at. 
T?e operator CfloaO means "Convert what follows into a 
5oat ' P CintD says that what follows should be converted into 

311 1 Type-casting operators are easy to use. Suppose b is an 
int yo y u want to divide by 4.2 with the resulting going into 
the unsigned short a. 
a = Consigned short) afloat) b / 4.2) 

would make certain that the compiler knows what's going on. 
First b is forced into a float before the division. Then the 
floating pom representation of b is divided by 4 2 and the re- 
sult s converted to an unsigned short before the result is 
stored Tl In general, you won't have to make explicit rype- 

CaSti Th^ to saT&U never have to use type cast- 
ing. Suppose a is an int. 
printfC" Answer is %d\n", a • 1.423); 
Since a is an int, it should be printed as an int, so %d is 
used. But in this case, a is not printed as an int a is .going to 
be cast to a float because the other operand is a float. I he re- 
sult is also a float, and will be passed Refloat 
printfC ) expects the next argument to be an int so the float 
will be printed as if it's an int. The number displayed won t 
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be anything like what you expect. There are two ways to work 
around the problem: 

printf(" Answer is %f \n", a • 1.423); 

or 

printfC" Answer is %d\n", Cint) (a * 1.483)); 

The frst solution is just to print the result as a float (with 
%f rather lhan %d). The second approach is to cast the result 
of the division to an int. This forces an int to be passed to 
printfC) »ther than the float. 

Notict that 

printfC" Answer is %d\n", (Int) a * 1.423); 

won't work because the cast operator Cint) has a higher prece- 
dence thai •. Thus the cast would be performed before the 
multiplicaion, accomplishing nothing. The result would still 
be a float and a float would be passed to printfC ) 

Bitwise Operators 

C also has a number of bitwise operators, some for the Boolean 
functions [or, and, xor, and not) and some for bit shifting. C 
uses the following symbols: 

~ not, also called one's complement 
« shift left 
» shift right 
& and 
I or 
xor 

All of these are binary operators, except for ~, which is 
unary. These operators only work with ints or chars. You can't 
use them with float or double. 

Bitwise not. The ~ operator is probably the easiest of the 
bitwise operators to understand. It inverts all of the bits of its 
operand. ]n other words, all of the bits which were 1 are set to 
0 and vie? versa. For example, consider the binary number 
010011015. -C010011010) is 101100101. This isn't quite the 
same as negating a number, but it's as close as you get with 
bitwise operators. For example: 

1 is C 

~2BB is -286 
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Negating a number is the same as 
~ number + 1; 

The reasons for this are, needless to say, rather obscure. 
As a C programmer you really don't need to worry about 
them. In any event, ~ is used like any unary operator. 

Bit shifting. The shift-left and shift-right operators are 
also fairly straightforward. They are used as follows: 

number—being— shifted operator number— of— times-toshift 

For example 

10 « 3; 

shifts the bits in the number 10 to the left three times. This 
has the effect of multiplying the number by 8 (2 to the power 
of 3). If you can visualize a binary number as a bunch of bits 
chained together, shifting the number to the left is like shov- 
ing a zero bit onto the right edge of the number. All of the 
other bits slip one position to the left. The bits which were at 
the left edge of the number fall off the end, and are ignored 
(Figure 3-1). 

Figure 3-1. Bit Shifting to the Left 



— i — i — i — i — i — i — i — 

00001010 




1 1 1 1 1 1 1 — 

00010100 
i i 1 i 1 1 1 — 



(10«1) 



(20) 



The shift-right operator is used similarly. For example, 
1642 » 4; 

shifts 1542 to the right four times. This is like dividing 1542 
by 2 four times (or dividing by 16). Thus, 1842 » 4 evaluates 
to 96 (we're dealing with ints here). Again, if you can picture 
a binary number as a chain of bits, shifting to the right shoves 
a zero bit onto the left edge of the number. The rest of the 
digits slip one position to the right. Those bits which fall off 
the right edge of the number are ignored. 
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Table 3-6. Truth Table for XOR 



A B (A * B) 

TRUE TRUE FALSE 

TRUE FALSE TRUE 

FALSE TRUE TRUE 

FALSE FALSE FALSE 

This is sometimes a little awkward in English, since the 
conjunction or is usually inclusive, but there are sentences 
which use an xor operator — for example, Tuesday night, I plan 
to take out Katie or Susan, not both. C uses the - to represent 
xor. 

(and), I (or), and * (xor) work on each of the bits of their 
operands one by one. For example: 

decimal binary 

1 I 4 is 5; 0001 I 0100 is 0101; 

31 lis 3; 0011 10001 is 0011; 

3 I 4 is 7; 0011 I 0100 is 0111; 

l»2is3; 0001 - 0010 is 0011; 

7"2is5; 0111 - 0010 is 0101; 

3'3is0; 0011 " 0011 is 0000; 

Bitwise assignment operators. Just as the arithmetic op- 
erators have analogous assignment operators, the bitwise oper- 
ators have corresponding assignment operators. Thus the 
following are allowed and encouraged: 

&= /• and 7 

1= /* or •/ 

— /• xor •/ 

«= /• shift left 7 

»= /* shift right 7 

a &= 3 is the same as a = a 6t> 3 and a «= 2 is equiva- 
lent to a = a « 8. 

The Boolean operators (and, or, and xor) are very impor- 
tant when it comes to decision making. When we begin to dis- 
cuss decision making, we'll add yet another twist to the list of 
C's operators. Decision making is the topic of the next chapter, 
and we'll talk about the logical operators there. 
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The relational operators allow you to compare the relative 
values of two expressions. There are six relational operators: 

> greater than 

< less than 

>= greater than or equal to 

<= les: than or equal to 

= = equal 

!= not equal 

Notice the differences between C and other languages. 
First, C uses = = to denote the equality operator, while most 
languages use a single equal sign (so that assignment and 
equality ire not distinguishable). Furthermore C uses != for 
inequality not "<>" as is used in Pascal and BASIC. In other 
respects, C's relational operators are similar to their Pascal or 
BASIC counterparts. 

These relational operators are used like any of the other 
binary oyerators previously discussed: 

10 > 3 
8 < 2 

3 == 1 
a != 3 
j <=k 

Thej can be used any place you would use operators like 
+ and — . But how are the relational operators evaluated? 
Since C ises 0 for false and 1 for true, 10 > 3 evaluates to 1 
(since 10 is greater than 3), while 5 < 2 evaluates to 0 (5 is 
not less trian 2). After the following code fragment, what will 
the variable a hold? 

la = 3; 
c = 8; 

a = c >2 + b; 

Remembir to check the precedence of the operators carefully. 
Which is evaluated first, 2 + b, or c > 2? The precedence of 
the + operator is higher than that of the > operator, so 2 + b 
is evaluated first. Then the result of this evaluation is evalu- 
ated with regard to c. Since c is equal to 5, and 2 plus 3 is 5, 
then the value of c (5) is not greater than 5 and the variable a 
holds 0 (false). 

C also provides a set of special Boolean operators for 
dealing with conditional expressions. These make up the sec- 



ond set of logical operators mentioned above. In form and 
usage they are very similar to the bitwise Boolean operators: 

ieSe and (like &) 
II is or (like I) 
! is not (like ~) 

These are called the logical Boolean operators to make 
them distinct from their bitwise counterparts. They differ 
somewhat in terms of how they are evaluated. && (and), 1 1 
(or), and ! (not) work much like their bitwise counterparts, ex- 
cept they return 1 for any result which is nonzero (true) and 0 
for any result which is zero (false). Some examples will help 
make this clearer: 

2 &•& 3 is 1 
4 11 8 is 1 
0 SeSe 843 is 0 
18432 is 0 

Both 2 and 3 are nonzero, so SeSe returns 1 . Both 4 and 5 are 
nonzero, so II returns 1. The 0 in the next example makes that 
tete zero. Finally, 5432 is nonzero, and, since ! of a nonzero 
number is 0, ! returns 0. 

The and 1 1 operators are used to build compound con- 
ditional expressions. For example: 

(a > b 1 1 c > d) 

will be true if either a is greater than b, or c is greater than d. 
Cf > 10 j < 8) 

This is only true if f is greater than 10 and j is less than 5. 

It's important to point out that these operators are han- 
dled somewhat differently in C than in other languages such 
as Pascal or BASIC. First, consider what does. It checks for 
the truth of both of its operands. If one of them is false, then 
the entire expression is false. The C language definition states 
that if the first operand evaluates to false, then the second op- 
erand is never evaluated. Thus, in 

(10 < 8 a > b) 

the expression a > b is never evaluated. 

Likewise, the 1 1 operator checks its first argument to see if 
it is true. If so, the second argument doesn't get evaluated. 
However, if the first argument is false, C checks the second 
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Statements 

Our current working definition of a statement is that it's a 
command — like printfC ), or any other function call. It turns 
out that an expression is also a statement, as are the built-in C 
statement such as If. You may have noticed that all state- 
ments end in a semicolon. Semicolons are used to terminate 
statement. 

Now return to the definition of the if command presented 
at the beginning of the chapter. It says that only one state- 
ment can follow the expression. If this were true, it would 
mean that if you wanted to do a whole bunch of things on the 
basis of cne if, you would either have one if for each of the 
things you wanted to do, or you'd make up a new function. In 
a sense, it's the second approach which C uses, but you don't 
really make a new "function." Instead, you build a compound 
statement a statement made up of a group of other 
statements. 

A compound statement is initiated with a { and is termi- 
nated by } . In a sense, functions are simply named compound 
statements. Of course, you could turn that around and say that 
compound statements are just "nameless" functions. In either 
case, wherever you can use a statement, you can also use a 
compound statement. For example, you might have an if 
statement which looks like this: 

if Ca >b) { 

a; 

printfC"%d a); 

} 

else ++*} 

The indenting lets you make sure that there are just as 
many } as there are { . This is important, as you're allowed to 
have nested compound statements (compound statements in- 
side othei compound statements; remember that you can use 
compound statements any time you can use a single state- 
ment). For example, we could nest statements like this: 

if Ca > to) { 
a; 

if (to > O { 

+ +c; 

printfC"%d", c); 
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C doesn't care how you indent or space out your code. 
You could write this as: 

if(a>to){ a;if(T»c){ + +c;printfC«%d",c);}} 

The style of indenting is up to you. You might want to ex- 
periment with different styles until you find one you like. (The 
style used in this book is typical of C programming in gen- 
eral.) Once you start using one style, though, stick to it. C 
source code can start to look very mysterious if the indenting 
style confuses you. 

In general, a compound statement has the form: 

variable declarations; 
statements; 

} 

This means you're allowed to declare variables anywhere 
in your program. All you have to do is open a compound 
statement. These variables are only defined while you're in- 
side that compound statement. Once you venture outside that 
compound statement, the variables' meaning (and contents) 
are lost. You can even declare static variables inside com- 
pound statements. These simply lose their meaning when you 
leave the statement, but always retain their values. Using local 
variables like this is probably not a good idea, since you could 
wind up with variable declarations scattered around the pro- 
gram. At the same time, if you desperately need a very local 
variable, this isn't a bad approach. Mostly, though, it's just a 
matter of style. 

if Again 

At this point let's create a statement by combining expressions 
and statements. To recapitulate— the if statement takes on the 
following form: 

if (expression) 

statement; /* statement if expression true */ 

else /* the else part is optional */ 

statement; /* statement if expression false */ 

If the (expression) evaluates to TRUE (remember, nonzero 
means true), then the first statement is executed. If (expres- 
sion) is FALSE (it's zero), then the statement after the else is 
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printfC Input the dividend: "); 
scanfC"**", *divd); 

The printfC ) is used to print a string, prompting for in- 
put. Clearly the scanfC ) is trying to read in a value for the 
int dive. The formatting string %d tells scanfC ) that it should 
read in an integer. %ld would make scanfC ) read in a long 
integer, %f would mean a float, and %c, a character. In fact, 
the percent escapes used by printfC ) are the same as those 
used by scanfC ). Thus %o would read in an octal int, and 
%x, a hexidecimal int. 

Thefc in front of the variable divd is called the address 
operator It returns the address of divd. This means that 
rather than pass the contents of divd to scanfC ), we are pass- 
ing the address of divd; in other words, we're passing where 
divd is stored rather than what's stored there. This way, 
scanfC > knows where to put the value it reads in. Passing 
scanfC ) what's stored at divd doesn't do much good, since 
that doesn't tell it where to store the information you've 
typed. (The address operator can be distinguished from the 
Boolean and operator, &, since the address operator is unary 
and the and operator is binary.) 

In a previous chapter it was mentioned that functions can 
only return one value. The & (address) operator lets us work 
around this limitation. We can use the & (address) operator to 
transfer the address of a variable; then we can store the result 
there. When the address of the variable is passed rather than 
its contents, computer people say that the argument is being 
passed by reference rather than by value. In the next chapter 
we'll explain the & (address) operator and its complement, the 
* (indirection) operator, more fully. 

Loops 

So far, all of the programs have been linear: We start at the 
top and work our way down through the code until we reach 
the end at the bottom. That's fine for some programs, but 
often you'll need to repeat some action from within a pror 
gram Older versions of BASIC offer only one looping con- 
struction, the FOR loop. Pascal offers WHILE-DO, FOR-DO, 
and REPEAT-UNTIL. C, like Pascal, offers three different loop- 
ing constructions: while, for, and do. 
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while. The while loop is probably the easiest of the three 
looping constructions offered in C to understand. It has the 
general form: 

while (expression) 
statement; 

As long as the expression is true, the statement is executed. A 
simple while loop might be 

while Ci < 100) + +i; 

The expression is i<100 and the statement is ++i. This sim- 
ple loop will increment i until it reaches 100. Of course, it's 
possible to have a compound statement rather than a simple 
one: 

j = 0; 

while a < 100) { 

printfC'%d\n", j); 

+ +J; 

} 

which will print the numbers 0-99. The C language definition 
guarantees that the statement will not be executed if the ex- 
pression in the while statement starts out false. This means 
that in 

while Ca < b) { 
+ +a- 

printfC"%d\n", a/b); 

the compound statement { + +a; printfC"%d\n", a/b) } will 
not be executed if a is greater than or equal to b when the 
loop is first entered. 

do. The do construction is similar to the while loop con- 
struction, except that the decision-making part is at the end of 
the loop rather than at the beginning: 

do 

statement; 
while (expression); 

The statement is executed as long as the expression is 
true. In a do loop, the statement is always executed at least 
once. The reason for this is that the test to continue the loop is 
performed after the statement rather than before it. Again, you 
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on at the moment. For example, suppose you want to print all 
of the numbers 0-100, except for those that are evenly divis- 
ible by 7: 

for Ci = 0; i <= 100; + +i) { 
if C % 7 = = O) continue; 
priatfC'Number: %d\n", i); 

} 

The continue statement aborts the iteration of the loop if 
i mod 7 is zero (that is, when i is evenly divisible by 7). You 
might ask why we can't program the loop this way instead: 

for Ci = 0; i <= 100; + +i) 

ifCi *> "JO printfC'Wumber: %d\n", i); 

(Remermer, any nonzero expression is considered true.) In this 
case, the latter coding scheme is probably easier to under- 
stand. When things are more complicated than this example, 
the continue statement might make more sense. 

Thebreak statement is a little stronger than continue, 
break, rather than causing the next iteration of the enclosing 
loop, ab»rts the innermost enclosing loop immediately. When 
you're inside a loop, break takes the program execution to the 
statement following the loop construction. For example: 

while Ci < 100) { 
++a; 

if (a == 0) break; 
pjintfC«100/a: %d\n", 100 / a); 

if ( a = = o) printfC'can't divide by aero\n")j 

The break here prevents a division-by-zero error. When 
the break is executed, the next command which is performed 
is the i£Ca ==0) printf.... Here, we're checking to see if the 
reason ve left the loop was an error (we're guaranteed, in this 
case, that a will be zero only if an "error" has occurred). 

Recursion 

There's actually one more way you can do a loop in C. When 
we talked about functions, we didn't mention one important 
fact. All C functions are recursive. This means that they can 
call themselves. One operation which lends itself nicely to re- 
cursive programming is the factorial function. The factorial of 
x is x*(x-l)*(x-2)...(l). In other words, the factonal of 5 is 
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5*4*3*2*1, or 120. Program 4-1 is a simple C program which 
calculates factorials. 

Program 4-1. fact.c 

/* 

* fact.c — program which finds the factorial of a number. 

* demonstrates recursive functions; some of the floating- 

* point libraries aren't very reliable, so don't trust 

* the really large factorials to more than about 5 or 6 

* significant figures. 
*/ 

/* 

* using scanf () and printf () 
V 

# include <stdio.h> 

main() ■ 

( 

/* 

* give ourselves a working variable, and tell the 

* compiler that fact() returns a float 
*/ 

float number, fact(); 

for (number = 1.0; number < 20.0; number += 1.0) 

printf ("%. Of! = %.0f\n", number, fact (number) ) ; 

) 

/* 

* find the factorial of a number by recursion 
V 

float fact(x) 
float x; 

{ 

if (x = 1.0) return 1.0; 

else return (float) (fact(x - 1.0)*x); 

) 



Programmers using the ST without a command line inter- 
preter should add the following lines just before the last clos- 
ing curly brace at the end of mainC ): 

printfC'Press RETTJMT to exit:"); 
getcbarC ); 

Consider how the function f actC ) works by looking at 
some sample cases. First, what happens when the program 
tries to find the factorial of 1? If this is the case, then the if 
will be true, and the function will return 1. The factorial of 1 
is 1. 

Now let's try 3. We enter with x. as 3. The if is false, so 
the program returns factC*)^. But this means the program 
must call factC) again. In this new incarnation of factO, x is 
2, the if is again false, so the program returns fact(l)*8. It is 
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gram, it could use the error code to determine if something 
had gone wrong. Programs generally exitCO) if all is well, and 
exitC) with some other number (often 1) when there has 
been a problem. (Usually a 0 indicates all is well, and any 
nonzero values signal that something is amiss.) 

You might have noticed the small size of the main input 
loop. This deserves some explanation. First, get-inputC ) re- 
turns HULL if there's been an error or if you've typed the 
end-of-file character. If either of these things has happened, 
we want :he program to exit. Thus the first check. As long as 
get_inpnt( ) doesn't return MULL, we want to run the pro- 
gram. Now let's turn to executeC ). executeC ) returns 1 (true) 
as long as you don't enter the quit command. If executeC ) 
returns 0 (false) then the user has asked to leave the program. 
Remember how works; if the first operand is false, then 
the second operand is never evaluated. This works out in our 
favor, since, if get_luputC ) returns NULL, we don't want to 
call executeC ). 

The Preprocessor 

plot.c makes more use of the preprocessor than the sample 
programs we've examined so far. The preprocessor is basically 
a text processor. In its pass through the source code, it strips 
out the comments and executes the preprocessing commands. 
These commands must begin on a new line, and their first 
character must be a '. 

#include. One preprocessor command we've talked about 
already is 'include. This command inserts the named file into 
your souice code. Usually, these are .n (header) files which in- 
clude definitions for the commands you're going to be using in 
your program. There are a number of "standard" include 
files; stdLo.h is among them. 

#define parameters; macros, 'define is probably the 
most powerful preprocessor command. You've already seen 
how it can be used to make simple text substitutions (see 
Chapter 2). But 'define allows more than just simple text sub- 
stitution. It can also be used to write macros. Rather than just 
substituting text verbatim, a macro has parameters the way a 
function has arguments. A very simple macro is one which 
finds an absolute value of a number: 

'define ABSCx) COX) > 0) ? 00 : ~00) 
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To use the macro, you just write it out in your souice . ode 
like a call to a function One thing to remember when using a 
macroTs that there can be no space between the macro name 
and the left parenthesis of the argument list: 

x = ABSCj); 

The preprocessor will change this into 
k = CCCi) > o) ? a) : -CD); 

When you write macros, you should be very careful aboulr pa- 
rentheses. You don't know what the parameter of the ^ao 
mSht be or how it relates to operators around it Generally, 
SS? good idea to surround everything in parentheses as is 
done in this example. Remember, this is a text macro, not a 
function. This means that what's really compiled is 

k = (((j) > 0) ? (j) : 

^ VMS b^a^ant issue when you're using mac- 
ros. Notice Tat our ABS macro will fail if we use it like this: 

k = ABSC++J); 

After the preprocessor is done with that, the compiler will see 
k = (XC+ +j) > o) ? C+ +j) » -C+ +D)5 
This isn't going to work very well, at least as an > abs olute 
value function" Suppose j is 3. The 

will increment J. The expresion C* > 0) is true, so the _expres 
sion right after the ? (the C++J) ) will be evaluated Thus J 
wm ^incremented again, k will get the va ue 5 and j is in- 
cremented twice. If ABSC) were a real function, then j would 
onlv be incremented once, as you would expect. 

Be careful to avoid side effects when you use macros. 
Many of the functions defined in stdio.h are macros > Th e doc- 
umentation which came with your compiler should tell you 
which a re macros and which are functions. By convenUon 
definitions and macros are often in uppercase, while functions 
and variables are in lowercase. _u oar i" than 

Macros are used because they have less overhead than 
functions. It takes time to organize and pass arguments to a 
function. For this reason, simple, time-critical functions are 
often implemented as macros. 
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turn on a blank input line. Amiga users can switch between 
the screen with the closed-Amiga-N and -M key combina- 
tions. Commands are one letter (in upper- or lowercase) fol- 
lowed by some arguments. 

The following commands are valid: c, h, 1, m, n, p, and q. 

c changes the current color. Follow c with a number be- 
tween 0 and 7. The colors are defined as in mackine-li. For 
example, the command c 1 will change the drawing color to 
white, and c 7 will change the color to magenta. 

h (or?) will print a brief help menu. 

1 draws a line. The syntax of this command is 1 followed 
by two numbers. The program will check for a valid input for 
your computer. The point must be on the screen. The first 
number is the x coordinate of the line's endpoint, and the sec- 
ond number is the y coordinate. 

m moves the drawing cursor to a point without drawing 
anything on the screen. It, like 1, takes two numbers— the x,y 
coordinates to move to. To draw a figure, use a combination of 
the 1 andm commands. For example, the sequence 

c 1 

m 100 ICO 
1 200 103 

draws a vhite horizonal line, 100 pixels long, from the point 
(100, 10C) to (200, 100). 

p plots a point on the screen and also takes two argu- 
ments: trie x,y coordinate of a point to plot. This point will be 
drawn in the current color. Thus 

c 3 

p 150 1C0 

places a green point at (150, 100). 
q, quit, exits the program. 

Program 4-3 is a short script file which makes plot.c draw 
the same figures on the screen as the PIGS program from 
Chapter 2. This demonstrates some of the capabilities and 
command syntax of the program. 

plotx should be compiled just like figs.c (Program 2-4). 
Refer to Appendix F for any problems. Atari Megamax C users, 
please see the special note in that appendix. 
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Program 4-2. plot.c 

/* 

* plot.c — graphics program to let user play with the different 

* graphics functions supplied in the graphics library. The different 

* commands map directly into the different routines. 
V 

/* 

* include some header files to get necessary definitions; we use 

* printf () and the like, so we should include stdio.h. plot.c uses 

* the graphics routines, so it must include machine. h 

*/ 

# include <stdio.h> 
((include "machine. h" 

/* 

* define constants for the different program states; these "states" 

* let the routine which figures put what command has been issued 

* and the routine which actually executes the command communicate 

* with one another. 

V 

#def ine ERROR -1 
((define NONE 0 
#def ine MOVE 1 
#define LINE 2 
#def ine POINT 3 
#def ine COLOR 4 
((define HELP 5 
((define CLEAR 6 
((define QUIT 7 

/* 

* tell the compiler ahead of time that these functions don't 

* return an int, but, instead, return no value at all. All of the 

* other functions are assumed to return int. 
V 

extern void die() , prompt() , help() ; 
/* 

* the main program loop 

v 

main() 

char inline[256] ; /* input line buffer */ 

init_graphics (COLORS) ; /* initialize the graphics */ 

/* 

* main program loop; Remember, execute() will never be called if 

* get input () returns NULL (end of file, or error condition) . 

V 

while (get_input( inline) && execute(inlme) ) 



die (NULL) ; /* leave the program 



* die(): 

* leave the graphics mode and return to the operating system via 

* a call to exit() . 
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/* 

* help() : 

* print out a help menu 
V 

void help() 

( 

printf ("Commands available :\n") ; 

printf ("c <value> — change color\n") ; 

printf ph — print this help message\n") ; 

printf f'l <x> <y> — draw a line from the current position\n") ; 

printf ("m <x> <y> — move the plotting cursor\n") ; 

printf fn — clear the screen\n") ; 

printf ("p <x> <y> — draw a point at the given position\n" ) ; 

printf Cq — quit\n") ; 



Program 4-3. plot.c script file 

c 

3 
n 

10 10 

1 

100 10 
100 100 
10 100 
10 10 

-1 -1 

c 
4 

n 

75 75 
1 

150 175 
0 175 
75 75 
-1 -1 
c 
6 

m 

300 125 

1 

119 159 
231 5 
231 195 
119 41 
300 125 
-1 -1 

q 
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The first element of the array always starts at the lowest 
address (see Figure 5-1). element] is immediately after ele- 
mented elementd] follows element[0]. This organiza- 
tion is important when you're using arrays as arguments to 

fUnC The S number between the brackets (CD) is called the index. 
When an array is declared, the index determines its size. 
When you use the array the index says which element you 
want to work with. For example, this line stores the number 
23 into the third element of the example[3 array (remember, 
C starts counting from zero): 
example[83 = 83; 

No other element of the array is changed— only the value 
stored in the third element. The elements of an array may be 
used the same as any other variable: 
example[8] = example[l] * 18 - exampleCS] / 3; 

for instance, or 

printfC'%d \ n", exampleCexampleCl]]); 
Side Effects 

When using arrays, you must be careful to avoid the side ef- 
fects Some side effects of using macros were mentioned in 
Chapter 4. The side effects involving arrays are more compli- 
cated. Here's an example of a method of writing C code which 
should be avoided: 

int i; 

i -= 3; 

a[i] = ++i; 

Does this put 4 into a[3] or a[4]? 

The results of this method of writing code depend on 
your compiler. Although you could write test programs and 
figure out how your particular compiler will compile the code, 
don't rely on it when you write C programs. Suppose you 
later wanted to install your program on a different system 
using a compiler which behaves differently? Your program 
wouldn't work. This defeats the purpose of working m a 
highly portable language like C. To maintain maximum porta- 
bility, avoid writing programs which rely on the quirks of your 
particular compiler or machine. 



Using Arrays as Arguments 

The individual elements of an array can be assigned to a runc- 
tion just as can any other variable. The entire array may also 
be passed as an argument: 
samplefuncCexample); 

Just use the name of the array and leave off the brackets. The 
declaration of samplefuncO will look something like: 

samplefuncCarray) 
int arrayC ]; 

{ 

• •• 

} 

The brackets say that you're passing an array. »ample- 
funcC ) doesn't need to know how big the array is In other 
words, you could pass samplefuncC ) any array of ^ts, not an 
array limited to a particular size. In general, be careful When ■ 
you use arrays. You don't want to use indices which aren t 
valid. Most C compilers won't complain if you write 

^ int exampleC83; 

if CexampleM == exampleC 7 . 
printfC"%d\»"> example[185]); 

You won't see an error message as you would with BASIC, 
but the results can be rather unpleasant. 

All of a function's arguments are passed by value, not by 
reference. This does not mean the entire array is pas sed Unto 
the function; the compiler passes the address of the array 
rather than the array itself. Thus 
samplefuncCexample); 
is basically the same as saying 
samplefuncC&example[OD; 

which passes the address of the first element of the array. This 
is the address of the base of the array. The result of passing 
the array's address is that the function isn t worbng with a 
copv of the array. Any values which are changed by the func 
tion are available to other functions throughout the program, 
not just within the called function. 
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This is one of several solutions. Another choice is to use a 
radial system, measuring how far we are from the origin, and 
an angle relative to a fixed axis (see Figure 5-4). This is like 
the ranging system you would use with radar: The enemy ship 
is at 45 degrees, range 300 meters. 

Figure 5-4. Radial Coordinates 




axis 



t 

origh 

In any scheme two pieces of information are necessary to 
determine precisely where you are. If we are on a plane, there 
are onl\ two "ways" we can go; that is to say, there are "two 
degrees of freedom." Two pieces of information are needed to 
pin down the precise values for each of the degrees of freedom. 

The two values for a coordinate are intimately related. 
One is useless without the other. For convenience, the two 
values are combined into a vector. In that sense, a vector is an 
array. Each element holds one of the two coordinate values. 

Using Vectors: Addition and Subtraction 

Vector arithmetic is really an extension of the arithmetic you 
learned in grammar school. Suppose we have a position vector 
like the one in Figure 5-5. It's pointing to the position (8 5). If 
we were at the origin and wanted to get to (8,5), we could fol- 
low that vector directly. We could also travel to (8,0) and then 
head up to (8,5). For the second path, we sum two vectors, 
one pointing to (8,0) and another pointing to (0,5), to get to 
(8,5) In other words, (8,0) + (0,5) is (8,5) (Figure 5-6). 



Arrays 
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which points in the same direction as (5,21), but is exactly ten 
units long, we would first normalize (5,21) and then scale it 
by 10. 

Figure E-9. Unit Circle 




Dot Product 

The dot product is yet another method of multiplying vectors. 
Vector scaling requires a vector and a simple number (called a 
scalar quantity) and gives you a new vector. Dot products re- 
quire two vectors but produce a scalar quantity. A dot product 
may be calculated by taking the sum of the products of the 
corresponding components of the two vectors For example to 
find the dot product of (4,5) and (7,9), multiply 4 by 7, and 5 
by 9, and then find the sum of the two multiplication opera- 
tions': (4*7) + (5*9) = 73. 

Bu; what does this 73 mean? The dot product indicates 
the degree to which the two vectors point in the same direc- 
tion If two vectors are perpendicular to one another, then 
their dot product is 0. If the two vectors are the same vector, 
then the dot product is the square of the magnitude of the 
vector. 

Cross Products and Three Dimensions 

The final way to multiply vectors that we'll discuss is the cross 
product method. In order for you to understand cross products, 
we must deal with three dimensions. Three-dimensional vec- 
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tors are really no more complicated then two-dimensional vec- 
tors. As with our two-dimensional example, the first thing to 
do is define the coordinate system. In two dimensions, the x- 
axis goes off to the "right," and the y-axis goes "up" (east and 
north on a map). For three dimensions, another axis, z, is 
needed to indicate depth (the "space" above and below the 
map). The definition of the z coordinate depends on whether 
you're in the U.S. or Europe. In the U.S., the z coordinate goes 
out of the paper; if you're from Europe, z goes into the paper. 

The U.S. system is called a right-handed coordinate sys- 
tem. If you position your right hand with your index finger 
pointing in the direction of x and your middle finger pointing 
in the direction of y, your thumb will point in the direction of 
z. Using your left hand and the same fingers will give you the 
European system (see Figure 5-10). This is where the right- 
hand and left-hand systems got their names. 

Figure 5-10. Left- and Right-Handedness 




left-handed right-handed 
coordinate coordinate 



The cross product requires two vectors, as did the dot 
product. However, rather than produce a scalar quantity, the 
cross product produces a new vector. The properties of this 
new vector make the cross product very important. Consider 
the two vectors in Figure 5-11. These two vectors can both be 
drawn on the surface of a single plane. We can build an area 
in the plane shaped like a parallelogram using the two vectors. 
The result of the cross product is a vector which is perpendicular 
to the plane which contains the other two vectors. The magni- 
tude of this new vector is the area of the parallelogram. 
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to return the value of the cross product. Many C compilers 
don't allcw functions to return complex data types the > way ar- 
rays do (Lattice is an exception to this rule.) To keep things 
simple ^'11 pass our cross-product function three objects: two 
veTors, md the address of another vector to return the cross 
product in: 

cross-pioductCv, w, result) 
float vFG, wpri, result[3]; 

{ rasultCO] - vCirwpj] - vOTwCiy 
resuitci] = vCO]»wC»] - vcarwCOD; 

resultca] = v[0]*wCl] - v[irw[0]; 

} 

To call this function, we use: 
float ODBC3], twop$], resulted; 
oneCOD - 2.0; oneCl] = 3.«! one ^~ ^\ 
two[03 = 43.8; twoCl] = B8.3; twoPQ = 4.1; 
crosB-productCone, two, result); 

and resmltn will hold the cross product of oneC] and two[]. 



IMatricBS 

A matrh is simply a two-dimensional array. Multiplication is 
the primary operation concerned with a matrix. Matrix multipli- 
cation is not really very complicated. It consists mainly of dot 
products. The basic idea is that you take the dot products of 
every row from the first matrix and every column from the sec- 
ond Here's a simple example multiplying two 2 X 2 matrices: 

c ;m: ;) 

2 X 2 neans that the matrices have two rows and two col- 
umns A 3 X 3 matrix would have three rows and columns, 
and a 4 X 2 matrix would have four rows and two columns. 

To multiply two 2 X 2 matrices, begin by taking the dot 
product of the first row of the first matrix and the first column 
of the second. This is the number that should go in the firs 
row and column of the product matrix. The dot product of the 
second row of the first matrix and the first column of the sec- 
ond matrix is the entry for the second row, first column of the 
produci matrix. Repeat this sequence for the second column of 



the second matrix to complete the second column of the prod- 
uct matrix. 

In other words, if these are the relative positions within a 
2X2 matrix: 
'lAlB\ /2A2B\ 

V 1C ID/ \2C 2D/ 

then to find their dot product you would 
^(1A * 2A) + (IB * 2C)\ /(1A * 2B) + (IB * 2D)\ 

V (1C * 2A) + (ID * 2C)/ \(1C * 2B) + (ID * 2D) J 

Or, using the above matrices: 
/(2 * 6) + (3 * lK /(2 * 7) + (3 * 9)\ 

^(4*6) + (5 * 1)/ \9 * 7) + (5 * 9)J 

equals 

X 14 + 27\ 
28+45/ 

which equals the product matrix: 

15 41 
29 73 

Note that if a and b are matrices, then a X b is not the 
same as b X a. When using matrices, be careful not to acci- 
dentally reverse the multiplicands (the matrices being multi- 
plied together). This is a very common mistake. In scalar 
multiplication, a X b is the same as b X a. 

This same method of multiplying matrices may be applied 
to larger matrices. The matrices don't even have to be square. 
There are some restrictions. You can't multiply a 2 X 3 matrix 
by a 2 X 2 matrix. There aren't enough rows in the second 
matrix to match all of the columns in the first matrix. t 

However, it is possible to multiply a square matrix by a 
vector, resulting in another vector, as shown below. Think of 
the vector as a 3 X 1 matrix and perform matrix multiplication. 

/8 + 18 + 12\ /38\ 
= 24 + 12 + 10 = 46 
\32 + 18 + 16/ V 66 / 
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Try applying it to some simple vectors. (1,0) works; it be- 
comes (C,l), a rotation of 90 degrees. (1,1) goes to ("U) as 
we would expect. You can see how it's possible to move the 
point a sector points to in some coherent fashion just by pick- 
ing the ight matrices. 

Suppose we want to both scale and rotate a vector. We 
can muliply the vector by a scaling matrix and then by a rota- 
tion matix: 

( 3 o\ / 4 \ / 12 \ (scale the vector b y 3) 
0 3/ \6/ \ 18 / 

(0 -l\ /12\ /-18 \ (rotate 90 degrees) 
, oHJ-U) 

This can get tedious if you have a lot of vectors you need 
to scale by 3 and rotate 90 degrees. If the scaling and rotation 
matrices are multiplied, the combined matrix will both scale 
and rotate a vector: 



C 

c 




This concept of combining matrices is very general. You 
can combine any number of matrices. It's only necessary to 
multiply the matrices once and to do one matrix-vector multi- 
plication per vector rather than two. 

More Sample C Code 

There are no new concepts involved in writing functions 
which multiply matrices by matrices and matrices by vectors. 
It's moie tedious than anything else. Let's start by writing 
code to multiply a matrix by a vector: 

/* 

* multiply a vector and a matrix together 
V 

mv2inult(cutv, matrix, vector) 

float ou1v[2], matrix[2][2], vector[2]; 

100 



{ 



outv[0] = vector[0]*matrix[0][0] + vector[l]*matrix[0] [1] ; 
outv[l] - vector[0]*matrix[l][0] + vector [l]*matrix[l] [1] ; 

} 

We're using the fact that arrays are passed by references, 
so it's possible to change the contents of <mtv[ ] and have 
other parts of the program recognize the change. 

This function demonstrates what is probably the most 
straightforward approach to multiplying a matrix by a vector. 
Just do each multiplication explicitly. If the vectors or matrices 
were any larger, you'd probably choose to use loops. This 
would reduce the amount of typing you have to do (and, ulti- 
mately, the size of the program), but it takes a little extra time 
to control the loops. We've used register variables for the 
counters in the following example in order to reduce the over- 
head as much as possible. To achieve the fastest possible 
routines, write out each multiplication, as was done in the first 
example. 

/* 

* multiply a vector and a matrix together with loops 
V 

mv3molt(outv, Tiatrix, vector) 

float outv[3], matrix[3][3], vector[3]; 

{ 

register int i, j; 

for (i = 0; i < 3; ++i) { 
outv[i] = 0; 
for (j - 0; j < 3; ++j) 

outvfi] -t- vector[j]*matrix[i][j]; 

) 

) 
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won't work properly if the string defined as text contains a 
percent sign, which would be evaluated as part of an escape 
sequence . If text held the string "Print decimals with 
&d\n", then printf( ) would see the %d and try to print an 
Int there. But you didn't pass it an int, so printfC ) would be 
confused. One way around this problem is to use %% when- 
ever you want to print a percent sign. The string "Print deci- 
mals with fc%d\n" makes printfO write out Print 
decimals with %d followed by a new-line character. 

The compiler treats string constants in a way which is 
compatible with arrays of char. When a function call like 
printf("hi there"); is written, the compiler creates the string 
hi there in memory, and then passes printfC ) the address of 
that string That's the same as if we'd declared an array to 
hold the string, and then passed printfC) the address of the 

arra Y- 

scanfC 3 also has a %s escape. The command 
scanfC'%8", text); 

reads in the next "string" and puts it in the character array 
text We didn't have to use the & operator here because ar- 
rays are always passed by reference. In other words, the van- 
able text is treated as a pointer to an array of characters. 

strlenO. The C libraries offer a wide variety of string 
functions. strlenC ) returns the number of bytes used to store 
a string— not including the zero byte, often referred to as a 
null terminator. So: 

char textCLa8] = "how long am I? \ n"; 
printf("the length of text is %d\n", strlenCtext)); 

reports tha: the length of text is 15 (don't forget to include the 
\n in youi count). 

strcpyl ). strcpyC ) copies the contents of one string into 
another string. For example: 
char text[188]; 

char mess[1883 = "This is a test message \n' ; 
strcpyCteit, mess) 

will copy the string "This is a test message \n" into the array 
"text[ ]". You could also use 
char text[1883; 

strcpyCtert, "This is a test message \n' ); 
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which does the same thing, but without the intermediate array 

me *strcmp() strcmpC) compares two strings, returning 0 if 
the sS areSentical, -1 * the first string occurs ear her in 
he alphabet than the second (in ASCII sequence), and 1 if the 
first string occurs later in sequence than the second. 

strcatO. strcatC) appends the contents of one string onto 

another. Thus: 

char textri88]; 
strcpyCtext, "Hello there"); 
strcatCtext, " you all \n"); 
printfC"%«»", text); 

results in the output Hello there you all. These and the other 
string functions should be documented in the manuals which 
came with your C compiler. 

Pointers 

When a variable is declared, space is allocated for the infor- 
mation the computer's memory. This gives the program 
somewhere to store the information for tha variable. It 
doesn't matter what kind of variable it is: static, global, or 
auto The exception to this rule are the register variables. Reg- 
Ker variables only use the processor registers, without using 
any memory. Since no memory is used with a register van- 
able the & (address) operator cannot be used. 
3 Th! variable refers to some address in memory (onij 
ter of the processor; from now on we're going to limit the dis- 
cussion to nonregister variables). Whenever you use a variable, 
the computer "looks up" the address of that variable. When 
n * Aerator £ used'the location of the variable, rather than 
what's stored there, is used. In other words, * gives u a poMer 
to the variable. It's often convenient to declare pointers. This 
s particularly important for the string functions, where point- 
ers^ ofte/required to return modified character smngs. 

Here's how to declare a pointer variable. This line de 
clares a pointer to an int: 

int *p_to_int; 

The onlv difference between this line and actually declar- 
ing an int is the The * is a pointer operator. When you use 
Her declaring variables, it simply means that you're declaring 
a printer. It doesn't assign any value to the pointer; it reserves 
space in memory for the pointer itself. 
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degrees This makes the sinO and cosO routines a little more 
accurate. Next, rotateC ) is called to rotate all of the points in 
the figure. rotate( ), in turn, calls make_rotC ), which returns 
a rotation matrix for the requested angle. rotateC ) then calls 
xnvmultC ) on each of the vectors in the figure to rotate them 
with the rotation matrix. draw_figC ) then calls scale_figC ) 
to scale the figure to the appropriate size. Next, a loop is en- 
tered which adds offsets to x and y and checks to be certain 
that the figure will fit on the screen. If it won't fit, 
draw_f LgC D prints an error message, erases the screen, and 
returns to the calling routine. Otherwise, it enters another loop 
to draw the figure. 

vector.c has the same user interface as plot.c from the 
previous chapter. The program will prompt with a =>. If 
you're using an Atari ST, you can switch between the text and 
graphics screens by pressing return on a blank input line. 
Amiga users can switch between the screen with the closed- 
Amiga-M and -M key combinations. A command is a letter 
followed by some arguments. There are seven commands: h, 1, 
q, r, s, t and v. h (or ? ) prints a brief help menu, q is the way 
out of the program, r lets you rotate the figure a certain num- 
ber of degrees. It takes one argument, the number of degrees 
to turn. The angle is relative to the last position. Thus the 
command r 20 is the same as doing two r 10's. The positive 
direction of rotation is counterclockwise, s changes the size of 
the figure, s also takes one argument, the scale factor. The ini- 
tial scal« factor is 2. The size you can make the figure depends 
on the size of your screen. 

t takes two arguments, and is the command which lets 
you mote the figure. The first argument is the number of 
pixels the figure should move. The second argument is the di- 
rection. Thus t 20 0 moves the figure 20 pixels to the right, 
while t L0 90 moves the figure 10 pixels up. The v command 
prints out some statistics about the figure: how large it is, 
where i1 is on the screen, and what direction it's pointing. 1 is 
the looping command. The general syntax of the 1 command is: 

1 <count>:<command> 

where <count> is the number of times the <command> 
should le executed. You have to put in the colon, and there 
can't be any space between the colon and the command you 
want to loop. You can loop any command, including v and h. 
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In general, though, the only commands you'll probably loop 
are r and t. 1 commands are handy if you want the figure to 
turn smoothly. For example, 
1 180:r 2 

rotates the figure all the way around in two-degree incre- 
ments. Similarly, 

1 50:t 2 0 

moves the figure 100 pixels to the right in 2-pixel increments. 
The result is very smooth-looking motion. 

One of the commands uses a feature of C we haven't 
really emphasized. Take a close look at how the LOOP com- 
mand works in the executeC ) routine. Notice that it loops the 
command by finding the count, and then passing executeC ) 
the string which is after the : . Remember, all C functions are 
recursive. This means we can have a function call itself. 

vector.c isn't a very versatile program, but it has all of the 
parts in it you'll need if you want to build something more so- 
phisticated. As a simple exercise, try to change the shape of 
the object. As written, the program uses a simple dagger 
shape. Modifying the shape is just a matter of changing the 
initialization of the array figC 3E 3 If your new figure doesn't 
have nine data points, adjust the global int figsiae and the 
array cur[ ][ ] as well. A more difficult challenge is to change 
the program so that it doesn't recalculate the display matrix as 
frequently. The program now recalculates the display matrix 
each time the object is displayed (after every command). This 
is all right for a small object, like the little dagger, but can get 
slow if you create a much larger object. 

This program begins the journey into graphics. By exam- 
ining the source code, you can see why linear algebra and ma- 
trices are so important. 

Program 5-1. vector.c 

/* 

* vector.c — demonstrate the use of vectors in 2d graphics. 

* The program is designed to draw a dagger and can be used 

* to manipulate it on the screen. 

V 

/* 

* include header files 
V 

# include <stdio.h> 
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'* 

* ROTATE adjusts the global theta variable. Actual rotation of the 

* figure is tone within draw_fig() . 



*/ 



/* 



else if (command = ROTATE) { 

sscanf (&c[l], "%f", &tmp) ; 
theta 4= tup; 

) 



* SCALE adjusts the global sfactor variable. As with rotation, the 

* actual scaling is performed within draw_fig() . 



V 



/* 



else if (command = SCALE) ( 

sscanf(&c[l], "%f", Stnp) 1 
sfactor = tmp; 

) 



* TRANS modifies the offset variables (relatively) ; faked by adjusting 

* the offsets with good old sin() and cos() . When the figure is 

* redrawn, :t will be in the new position. 



*/ 



/ 



else if (command — TRANS) ( 

sscanf (&c[l], "%f%f", &rad, &dir) ; 
off[0] +- rad * cos(dir * 3.1415927/180) ; 
off[l] -*= rad * sin(dir * 3.1415927/180); 

) 



* print the help menu 
V 

else if (command 

'* 

* print a s-atus report 

V 



HELP) help(), 



V 



/ 



/ 



else if (command = STATUS) status () ; 
return FALSE if we're ready to quit the program 
else if (command — CUIT) return 0; 

* parseQ could return NONE or ERROR; we ignore these here, since 

* none means do nothing, and if ERROR is returned the user has 

* already been alerted to the problem 
V 

else if (command = NONE | | command = ERROR) return 1; 

* ack! we're not in a known state. Output an error and then 

* put the p:uyiaiu in a known state. This is a bad sign, the 
computer is probably about to crash. 



V 



elseprintf ("Unknown program command!\n") ; 
return 1; 



* draw the figure on the screen. Clears the screen before it tries 

* to do any drawing. If the figure doesn't "fit" on the screen, then 

* it prints an error message, clears the screen and does nothing. 
V 

void draw_fij() 



{ 



int i.; 

FLOAT tx, ty; 

if Ctheta >= 360.0) theta — 360.0; /* keep theta 0 <-> 360 */ 
else if (theta < 0.0) theta += 360.0; 
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rotate (theta, fig, cur, figsize) ; 
scale_fig( sfactor, cur, cur, figsize) ; 



/* rotate the figure 
/* scale the figure 



* check to make sure that the entire figure is going to fit 

* on the screen, y-coordinate is inverted so that (0,0) 

* to be in the bottom left, rather than the upper left comer 

* of the screen. 



V 



for (i = 0; i < figsize; i++) ( 
tx - cur[i][0] + off[0]; 
ty - y_size - (cur[i][l] + off[l]) ; 
if (tx < 0 | | tx >= x_size | | 

ty < 0 || ty >= y_size) { 

printf ("Figure is off the screen\n") ; 

clear () ; 

return; 



cur[i][0] = tx; cur[i][l] = ty; 



) 

clear() ; 



/* clear screen 



/ 



* draw the figure with the draw() command. By now, we know that 

* the figure will fit on the screen, so there's no need to check 

* the values going into move() and draw() . The type casts are 

* absolutely necessary, since move() and draw() both expect SHORTS, 

* not floats. 



*/ 



move( (SHORT) cur[0][0], (SHORT) cur[0][l]); 
for (i = 1; i < figsize; i++) 

draw( (SHORT) cur[i][0], (SHORT) cur[i] [1] ) ; 



* parse an input command, and return the command which was 

* requested. Print an error message if an unknown command 

* was entered. 

V 

int parse (d) 
char d; 



{ 



if (d >= 'A 
if (d = "h 
else if (d ■ 
else if (d ■ 
else if (d . 
else if (d = 



&& d <= 'Z') d ^ ('A' - 'a') ; 
|| d= '?') return HELP; 
• '1') return LOOP; 
■ 'q') return QUIT; 
r') return ROTATE; 
s') return SCALE; 
else if (d = 't') return TRANS; 
else if (d = 'v') return STATUS; 
else if (d = '\0') return NONE; 
else ( 

printf ("Unknown command\n") ; 
return ERROR; 

} 



/* 

* print out a help menu 
V 

void helpQ 

printf ("Available commands :\n") ; 

printf ("h — this help menu\n") ; 



.'[x][T]xt;q.Eui * [t]ut + [T][o]xrxiEm ♦ [o]tft = Ixlvo 
i[0][T]xr^eui ♦ [I]ur + [oJ[o]xtJ}Eui * [o]ui = [OJVW 

i[e]v» '[z]ut '[z][z]xtx;eui iwcru 

(vra 'ut 'xx^eui)-}x™aui pxoA 
A 

[«xt] [umnxoo]xrx;Eiu se pautjap sx xxj^bui aiR }bi«. saumss? * 
• jotpsA B Aq XTXiau zxj b AxdtTp™ :o/n oaqumu aupnoi asaou *:cort ♦ 

*/ 

{ 

(fax&ue (sTCtnop) Juts - 0H3Z = tfl] [x]xxx*bui) - CWHZ = [l][0]xt^Biu 

/„ artXBA quxod fux^BOXJ B a^B&au },ubo XVWfSQW */ 
jfaxfiue (atqnop) Jsoo + <ro'= [0] io]xt^E«t = [1] [x]xtxiEui 

/* suoib (Jsoo 3ABU. ^|UEO '6nq */ 

.'o-osx/Azegiffc =» si^ue } 

![z][z]xtXiEUI '3X&IB JMOXi 
(xtxiBui 'ai&jBj^ca a&fEUi ptoA 
A 

•„[«xt] [umnxooJxxjQBUi,, se pauxjap sx xtm^bui * 
an w 'JBaio aq :pu qupxiu sxux -siraxxduioo aucs .101 Ajbsssosu ♦ 
si }seo au4 os 'sa T qnop :padxs (Jsoo puB (Juts }BU} ao-pou osiy * 



HI 

■ (qx irxm auop sx yioi\ „TBaa„ aub atojaq susxpei cq. paqaaAuoo s.qx * 
q.BUi aotqou) saai6ap „ax6ue„ 10 mrq. b aoi xtxqeui uoxqeqaz B pxxtvq * 

»/ 

{ 

.'([tjqno '[x]ut 'q.Bmq.oa)4TrraAui (++x ;azxs > t .'0 = T)_ joi 
A xtjqeui pxxnq */ •' hEuqcu 'B^aLRj^oi sxeui 

;[Z][2]iEuqca: jraau 
.'x qux J3q.sx£ea 

} 

.'32X3 -yjT 

'•LZlllVO '[Z][]ux 'B^aio ,ITOli 
(azxs 'qno 'ut 'BqaqqJaqBqca pxoA 

A 

•XXJ^EOI * 

uopEica V&xj. am ib£> oq ()^ca _ aricEui stibo uoxqounj sxux * 
(O'O) punare am&ti b ux saoqosA av} io'xxb a^Kjcxt * 

*/ 

{ 

.'[X]Ut * JO^OBJ = [IJVIO 
.'[0]ut * JoqoBi = [o]qno 

) 

•'[zJvio '[e]ut 'j(xpbj jwau 
(qno 'ut 'acxpBjJaxBos pxoA 
A 

„aoqjOBj„ Aq jroqoaA ax&rts B btbos :auo aaquinu autqnoi asaoq x^°n * 

*/ 

{ 

.'([tjqno '[x]ux 'aoqoBiJaXBOs (++x .'azxs > t .'0 = x) .101 

.'x qut oa^sx6aa 

) 

.'azxs hit 
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*/ 

{ 
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A 
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*/ 

{ 
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.' (,,u\qxnb — b.JiqutJtd 
.' („u\sauixq. <q.unoo> <pueumE)0> doox — <pueuiiiiDO> : <4unoo> XuJj^utad 
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member operator. For example, to refer to the longinteger 
member of this example, use 

examplt.longinteger = 12L; 

(Remember, the suffix L on the 12 tells the compiler that 
you're defining a long int constant.) When you declare a 
structure variable, it's not actually necessary to use a structure 
tag. You could use 

struct { 

ixt integer; 

fl»at floatingpoint; 

long longinteger; 
} example; 

to declare the variable example. It accomplishes the same 
thing as first defining a struct sample and then using it to 
declare example. Doing things this way simply eliminates the 
intermediate sample part. You'd only do this if the structure 
were used only once in the program. Generally, you'll want to 
use a stricture tag so that you can refer to the structure over 
and over again without retyping its entire definition every 
time it's needed. 

Pointeis and Structures 

In the last chapter, pointers to simple data types and to arrays 
were used. Pointers can also be used inside structures. For 
example, 

struct filespec { 
char 'drive; 
char 'directory; 
char 'filename; 

}; 

declares 4 structure with three pointers in it. One points to an 
array of chars called drive, the next to an array of chars called 
director/, and the last points to an array of chars called file- 
name. Here's how to assign values to the various fields of the 
structure: 

struct filespec name; 
name.drive = "dfO:"; 
name.directory = "/fonts/topaz"; 
name.filBname = "11"; 
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Each of the pointers may be treated as an array: 
printfC"%c\n", name.drive[l]); 

This line will print an f . First, the %c escape for printfC ) 
makes it treat the corresponding argument as a single charac- 
ter, name.drivefl] is the second element in the array of char 
called name.drive. name.drive holds the string dfO:, and the 
second letter of that (the second element in the array of char) 
is f . printfC ), then, prints the letter f . You could treat them 
with the * operator: 
printfC"%c\n", 'name.filename); 

would print a 1. 'name.filename returns what name.filename 

is pointing to. It's pointing to the first character in the array 
11. Thus, 'name.filename returns the character 1. Remember, 
however,' that declaring a pointer does not declare room for the 
thing the pointer refers to. Thus the definition of filespec 
above is very different from 

struct newfilespec { 
char drive[66]; 
char directory[663; 
char filename[64]; 

}5 

even though it can be referenced in exactly the same way. 
This brings up an important point about assigning values to 
strings. The = operator assigns the pointers to the strings, not 
the strings themselves. Thus 

char 'example; 

example = "hi there \n"; 

is valid, since it points example to the text hi there \n which 
has been stored somewhere within the program (as constant 
data). Here's an example that won't work: 

char example[128]; 
example — "hi there \n"; 

example is no longer a pointer, but an array. It's necessary to 
use the C library function strcpyC ), which copies the contents 
of one string to another string as shown below. 

char example[128]; 
strcpyCexample, "hi there \n"); 

copies the message hi there \n into the string example. It 



121 



£Zl 



■J3}UT0d 

jo pup Aue 01 C )oorP«n Aq paum;ai ia;uiod aq; uSisse Abui 
no^ -ia;uiod pauSqE AjqB;ms e sum;ai C )ootthto 'iaA3Moj-j 
•*tit ub q ia;uiod b o; ibtid b o; i3;uiod b uSissb I3A3U pinoqs 
no;, -psuSqe os aq ;snui »u| o; sia;uiod ;nq 'pauSqE AjqE 
-;ms sAevqE ;,uaiB mho o; sja^uioj Aiouraui q;iM paw£z/» %o 
-jzns aq Q pres si is;uiod b qan$ uaquinu uie;i3d b Aq aiqisiAip 
ajusas st qDiqM Aiouiaui jo ssaippE ub ;b ;ie;s ;snui sia;uiod 
(xvno idaoxa adA; b;ep Aue AnEnpB) e;bp jo sadA; auios 104 
■santBA x^uiod a§uEqDia;ui 04 atqissaj sAemje ;ou s,q Aiouiaui 
aiCTone AjjEDiuiEuAp o; paau noA iaAauaqM pasn aq Abui 
C )Don«ra xbho 01 ia;uiod b Suium;ai sb pauiiap AqEnsn si 
( )oornw -pa}BoonE Aiouiaui 10 siBqa jo laquinu aq} 'ia;auiEi 
-Bd a«o sa>iB} qDiqM 'C )ooitbto uoipuni AiBiqq 0 aq; Suisn 
Aq si 3 q;tM Aiouiaui jo BaiE ub aAiasai o; Abm ;saiSBa aqx 

( '( )joazis '( pouew 

Aiouiaui papa;oid paqeD s,;EqM aABq 
sia;n«IuioD qons Aiouiaui pa;BDon_E s;i 10 ;no sda;s uiEiSoid 
e uaqA Joxia uiEiSoid b asriBD qoiqM saoiAap aiBMpiBq aABq 
sauiEijuiBui puB sia;nduiODiuiui auios 'UiEiSoid iaq;ouE Aq 
pasn Suiaq B;Ep 10 do; uo E;sp s;i 8ui;ijm uiEiSoid auo ;ubm 
; upmow' noA -;no daa>i ppoqs suiBiSoid iaq;o Ajouiaui ;sq; 
asn o; pssoddns si ;Eq; auo Ajuo aq; si ;i pa;BDonE qDiqM uieiS 
-oid aq; 'pa;B3onE uaaq SBq Aiouiaui jo BaiE ub aauo Aiouiaui 
to dv3t b uioii pa;BDOHB si ;i 'pa^DoqE si Aiouiaui uaqM 
3 A^jadojd 

(saAup >isip aq; 10 Aiouiaui sb qans) saDinosai s,ia;nduiOD aq; 

aacqs suiBiSoid ;uapisai-oa aq; ;Eq; ;uE;ioduii s,;i ';uauiuoJ 
-iAua 9ui>iSB;qinui B Suisn aiB noA uaqM A;qiqB Sui>isE;qinui 
10 aaiSaD b wjjo soaWHO P UB SOO? S ™*V q;og "SupiSB^inui 
uoddus suia;sAs §ui;BJado jaMau Aubt^ -sia;nduioD iBuosiad 
qiiM jasn Apauuoj'sBM ;Eq; qoBoiddE aq; si siqi Aiouiaui 
s ia;nduioD aq; jo n« ^ n UB3 I os 'Sui uum uiBjSoid Aiuo aq; 

si uniSoid Ajai,, :aSuEj;s ap;ii b uiaas ;qSiui Ajouiaui §ui;bd 
-ottb jo;daauoa aq; '(aun; e ;b uiEiSoid auo una Aj_uo ued ;Bq; 
ja;nduiOD b ui 'si ;Eq;) ;uavuuoJiAua SupisB;-ai2uis b ui 

•ain;Dnj;s £x%tib ub sb Ajouiaui jo >iaoiq ;Bq; ;eai; 
uaq; puB ';i paau 3av uaqM Aiouiaui jo >po{q e d}Vdo\]V f\\\vo 
-xiumh o; ;ubm aM 'suua; a;3tduioD ui - 3DBds dn SupiE; ssin; 
onj;s £x\xl* A;duia aq; jo \\e aABq ;,uop 3M aouis 'Suiuuni s y ;i 



ZZl 



uaqM janEuis uiEiSoid aq; sa>jBui siqx AiBssaaau uaqM Apjo 
ainpru;s JLx%v9 ub d-\voo\\v o; ia;;aq s ; ;i -auo ;saq aq; ;ou ;nq 
'qDEOiddE auo si ;Bqx ,;aq paau sb auo Aq auo uiaq; asn ;sn( 
uaq; puB 'paau o; SuioS ai,aM >{uiq; aM sb Aueui sb aiBpsp 
-aid 3m oq ^.uiaq; Suisn 3ioi3q s3iqBiiBA sb S3inpni;s sq; 
aiBpap aM ubd moh ApEai^B uis^qoid b ssoide 3uiod sa-^m. 

uoiy80O\\y Aaouiaj^t oiuitbuA(j 

•S3ii;u3 ssaippE jo ;sq 
aq; ui 3inpni;s £x%ua ;x3u sq; o; ;uiod o; p3sn aq ||im p{aij 
siqx -3inpni;s ii;ns ub o; i3;uiod b '%xan ssuuap ppij siqx 
•;siii 3q; si iBquosd uiaas ;qSiui qDtqM pptj A^uo aqx 'siEqo jo 
Abiib ub uEq; ;uapiija-aDBds aioui ap;q e si ;i sb 'apoo diz aq; 
aio;s o; pasn si $uoi y 'spjaij xis SBq ALi^tia ampni;s aqx 

f { 

<opood|z 3uoi 

i^XBXl, £x%uo lof-tis 

} £x%ub 5.0110:5.8 

:uiEiSoid >[ooq-ssaippB ajduiis e q;tM 
pa;BpossB uoi;buiiojui aq; ppq o; qinq aq pjnoD ;si[ pa^uq v 
•ureqo aq; ui y[ui\ iaq;o auios o; papauuoa si >juq qaBa aiaqM 
'uiBqD e a>iq ;no s>{iom q -;i o; ia;uiod e SuiABq Aq ;sq aq; 
ui ampni;s ;xau aq; jo >{dbi; sdaa>{ ampni;s qDBa ;sq pa>juq 
e uj -sfsij payuii paqso Suiq;auios o; ;iosai Abui siauiuiBiS 
-oij -ai_i;EsiaA 3io\a si qDiqM poq;aui ieuoi;eziubSio auios si 
papaau s 7 ;EqM 'Supiuiq 00; si Abiib ub uaqM sauii; aiB aiaqx 

•pa§UBqa aq ued o; ;uiod 
Xaq; Aiouiaui aq; A^uo .'paijipoui aq ; ( ued saAjasuiaq; sia;uiod 
aqX :sia;uiod ot^b^s sb sAexib s;Bai; la^iduioa 3qx Aiouisui 
ui uoi;edoi Aue o; ;uiod o; paAoui aq ued jbho o; ia;uiod anx} 
V 's^iod ;i aiaqM aSuBqD ;,ubd noA 'Aeiie ue sb paiBpap si 
aidmBxa aDuig Abiib aq; jo s;iBd suouea ssaDDE o; , 10 C 1 asn 
ubd noA '3sbd isq;i3 uj - o; s;uiod ;i ;Bq; Aiouisui aq; 10 s;ua; 
-uod aq; sa§uEqD ;nq 's;uiod sidtaBza aiaqM a§usqD ;,usaop 




To determine how many chars are held in any particular 
structure, use the sizeof operator, a unary operator: 

struct entry temp; 

printf("entry takes up %d chars. \n",sisseofCstruct 
entry)); 

We could have used sizeofCtemp) instead. Generally, it's up 
to you to decide which you want to use, the variable which is 
declared as that type, or the type itself. Note that you can also 
do something like sizeofCint) to find out how large an int is. 
When you're working with strings, the sizeofC ) the char ar- 
ray might be different from the length of the string. sizeof( ) 
will tell you how many chars you allocated to the string, while 
strlen( ) will tell you the length of the string you've stored 
there. 

Even though sizeofC ) might look like a function, it isn't. 
sizeof( ) is evaluated when the program is compiled, not 
when it's run. The compiler substitutes the "call" to sizeofC ) 
with the appropriate numeric constant. 

With mallocC ) and sizeofC ), you're ready to dynamically 
allocate memory. If we want to allocate an entry structure, we 
use 

struct entry 'pentry; 
extern char *malloc( ); 

pentry = Cstruct entry *) mallocCsizeofCstruct entry)); 

Most compilers will generate a warning if you don't put 
in the type-cast (the Cstruct entry *) operator). The reason 
for this is simple. The compiler knows that pentry is sup- 
posed to point to an entry structure, but mallocC ) returns a 
pointer to char. The type-cast eliminates that problem. Thus, 
mismatched pointers are generally considered a noncritical 
warning rather than an error requiring modifications to the 
source :ode. mallocC ) returns a MULL pointer if it can't allo- 
cate an^ memory. You should always check for this condition 
and take some appropriate action (like print an error message 
and exit). 

When a previously allocated area of memory is no longer 
needed it's a good programming practice to free the memory 
so that other programs can use it. Most compilers allocate 
memory so that when you exit the program all memory allo- 
cated by the program is freed automatically. This was not the 
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case for the first release of the Lattice compiler for the Amiga 
(v3 02) This has since been corrected. In any case, it's a good 
idea to use the C library function freeC) to free up memory 
that you've allocated via mallocC). freeC) takes one argu- 
ment, the pointer to the memory you want to de-allocate. Inus 

char 'memory; 
extern char 'mallocC ); 
memory = mallocC10»400); 

if (memory NULL) printfC" couldn't allocate 

memory! \ n"); 
else freeCmemory); 

quickly allocates and releases 100K of memory. You have to 
be careful when you use freeC). Most implementations of 
freeC ) don't check to make sure that the memory you re tree- 
ing is really allocated to the program. The results are unpre- 
dictable if you accidentally use freeC) with the pointer set to 
an area of free memory. 

Another function useful in managing memory is callocc J. 
callocC) returns a pointer to enough space for a number of 
objects of a specified size, or returns a NULL if the request 
cannot be satisfied. The storage area is initialized to 0. I he fol- 
lowing program lines will initialize an array of 12 floating- 
point variables: 
float 'array; 

array = callocC18, sizeofCfloat)); 
Linked Lists 

The general idea of a linked list is to point the next field at 
the next structure in the list. It's customary to set a pointer to 
HULL if it's not pointing to anything at all. This makes it easy 
to know if you're at the last structure on the list. 

Consider this small routine to add one structure to a 
linked list: 

struct entry •addnodeCwnere) 
struct entry *wnere; 

{ 

struct entry 'temp; 

if (where - - 1TOXL) { 

temp - (struct entry *) malloc(siseof(struct entry))) 
temp->next - BTJI.Ii; 
return temp; 

} 
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remaodeC ) removes the structure immediately following 
the structure pointed to by where. The general scheme is to 
"remember" the structure we want to remove, snip it out of 
the linked list, and then free the memory allocated to that 
structure 

Figure 6-2. Removing a Node 

remnode (where) 
whsre 





A 













NULL 



temp — where->next 
whtre 

V 

\l — 



temp 

\ 



where-nexl- where-next-next 




free(temp) 



wh;re 



It would be impractical to write a routine which removes 
the structure pointed to by where because there aren't any 
pointers from this structure to the structure preceeding it. We 
wouldn't know how to link the part of the list after where to 
the part of the list which comes before it. This is a limitation 
of linked lists of this kind. This is an example of a singly linked 
list. It is anly linked in one direction, from front to end. 
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There are also circularly linked lists. These are linked so 
that the last structure points to the first one You could also 
have a doubly linked list which is linked in both directions. 
Each structure would have a pointer to the next structure and 
to the previous structure. 

Figure 6-3. Linked Lists 



singly linked list 



■ NULL 



circular linked list 




doubly linked list 



NULL" 



-NULL 



doubly-linked circular list 
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A Specialized Else-If: switch 

When the if command was introduced, we explained how you 
could build an if ... else if ... else if ... construction with this 
example: 

/• the char infunc holds the function symbol */ 

if Cinfurc == 70 printfC" division"); 

else if Cinfunc = = '*') printfC'multiplication"); 

else if (infunc = = ' + ') printf C'addition"); 

else if Cinfunc == '-') printf C'subtraction"); 

else primtfC'invalid symbol"); 

/• more code follows */ 

domathCLnfunc); 

C ofJers a much more elegant way of handling this kind 
of constriction. We can use the switch and case commands: 

switch Onfunc) { 

caie 7 ': printfC'division"); break; 
caie «•': printfC'multiplication"); break; 
caie «+»: printfC'addition"); break; 
case «— printfC" subtraction"); break; 
default: printfC'invalid symbol"); break; 

} 

domathCLnfunc); 

The switch evaluates infunc, which must be an integer 
expression, and then compares its value to all of the cases. 
Each case must be labeled by a character constant or an inte- 
ger expression. If none of the cases match, then the default 
case is used. The default case doesn't have to be at the end; it 
can go anywhere. You must put a break command at the end 
of every ease, however, or the computer will execute the fol- 
lowing case. The break command causes an immediate end 
to the switch . When a break is encountered, we immediately 
go to the call to domathC ). Each case can only have one ob- 
ject for evaluation. You cannot do this: 

switch Cinfunc) { 

case 7*, ***! printfC"mult/div"); break; 
case ' + ','-': printfC"add/sub"); break; 
default: printf ("unknown"); break; 

} 



n? 
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Instead, you must use 

switch Cinfunc) { 
case */': 
case '•'»- 

printfC'mult/div"); 

break; \ 
case '+': 
case '— ': 

printfC"add/sub"); 

break; 
default: 

printf C 'unknown' ')? 

break; 

} 

Unfortunately, many compilers won't detect an error if 
you do try to write code with more than one object for a case; 
however, the program will not compile properly. 

The <stdio.h> Library 

One feature of the C language is that it has no input/output 
(I/O) routines included as part of the language. Instead, a file 
is included with each compiler for the specific computer that 
the compiler was written for. This file, stdio.h, consists of 
computer-specific input/output functions, stdio.h contains 
macros and variables used by the I/O library. The input/ 
output functions used by the C language have been derived 
from the UNIX operating system. 

When a program writes data to the screen with printfC ), 
what it's really doing is sending characters to the standard 
output device (called stdout) — in this case, the monitor 
screen. The scanfC ) function then reads the character from 
the standard input device, called stdin. These devices can be 
the terminal (the keyboard and screen) or a disk file, making it 
easy to redirect input and output to and from a program; just 
redirect it to the appropriate device. 

There is another standard device: stderr. Any error mes- 
sages are sent to stderr. The reason for separating stdout and 
stderr is simple. If an error condition is encountered and an 
error message is sent to stdout, and the output has been redi- 
rected to a disk file, the user won't see the error message un- 
less the file is read. By using stderr, the error messages can 
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You con't have to use the names argc and argv[ X but 
these are :he names used by convention, argc holds the num- 
ber of argaments which are passed to the program, argv is a 
pointer to an array of character strings that hold the actual ar- 
guments (argvf]). Generally argv[C] is the name of the pro- 
gram whi;h is being executed. Thus, argc is usually at least 1. 
(There is one exception to this rule: On the Amiga, a program 
run from the Workbench will normally have argc = 0.) The 
rest of the argvf. ] array holds other arguments. Before you 
start working on graph., take a look at Program 6-1. It's a sim- 
ple program which will print all of the command line 
arguments. 

Program 6-1. options.c 

/* 

* simple prtgram to print command line arguments 
*/ 

#include <stiio.h> 
main (argc, ajgv) 

int argc; /* number of arguments */ 

char *argv[ ] i /* pointer to an array of strings */ 

( 

int i; /* counting variable */ 

/* 

* print out each argument, one by one 
V 

for (i= 0; i < argc; ++i) printf ("%s\n", argvfi]); 

> 



Using graph 

To run gnph on the Amiga, you simply issue the command 
graph from the CLI. On the ST, double-click the graph.tos 
icon to run it from the desktop. The graph, program can also 
use command line arguments. These command line arguments 
will be a 1st of files which hold coordinate data that the pro- 
gram can use for drawing the graph. The first number in the 
data file is the number of data points in the data file. The data 
points are given as x,j/-coordinate pairs. The program auto- 
matically scales the data so that it uses the entire screen. The 
sine.c program, Program 6-8, generates a data file called 
sine.dat which is compatible with the graph program. To 
graph sim.dat, use the command graph sine.dat on the 
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Amiga, or on the ST, rename graph.tos as graph.ttp ; then 
type sine.dat as the parameter in the TOS Dialog Window. If 
you are using a command line interpreter with the ST, pass 
the parameters the same as with the Amiga. 

graph has ten commands. The first letter of each com- 
mand is unique, but you can type as many letters as you want. 
After you've issued a command, the screen is redrawn to re- 
flect the changes. Note that the display is drawn in the order 
in which graphs were loaded into memory. So, if you have 
two datasets, then the dataset which was loaded first will be 
displayed first. This will set the scaling of the screen, so the 
graphs which follow will be drawn using the same scaling as 
the first graph. This lets you intermix related datasets. The 
scaling is re-evaluated every time the screen is redrawn. 

If you're using an Atari ST, you can switch between the 
text and graphics screens by pressing return on a blank input 
line. Amiga users can switch between the screen with the 
closed-Amiga-N and -M key combinations. 

The commands are as follows: 

color <dataset> <color>. Change the color of the speci- 
fied dataset to the specified color. If you want to change the 
color of graph "sine.dat" to blue, use the command c sine.dat 
bine. You can find out what colors are valid with the com- 
mand help colors. 

fit <dataset> <new dataset>. Do a least-squares best 
line-curve fit on the named dataset and put the fitted line 
into new dataset. The new dataset will be drawn on the 
screen If you want to find the best-fit line of sine.dat, use 
the command f sine.dat fit, which will put the fitted line into 
a dataset called fit. 

help. Print a help menu. You can also use help colors 
and help modes to learn more about the available colors and 

modes. . . 

log <dataset>. Converts the named dataset into log-log 
dataset. Doing this makes the graph look the way it would if it 
were plotted on log-log graph paper. This is generally done 
with any data which is exponential in both the x and y coordi- 
nates (like frequency-response curves). 

mode <dataset> <style>. Changes the style of the speci- 
fied dataset to the specified style. There are four different 
styles which you can use: 
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Chapter 6 



main() is declared to utilize command line arguments. 
mainC ) begins by declaring some local variables, an array of 
char to hold the input line, a pointer to a PLOT structure, and 
a counting int i. Next, the graphics routines are initialized by 
calling iQ.it_graph.icsC ) and assigning the default color and 
style to the first PLOT structure. Then each command line 
argument is evaluated. Each argument is treated like a file- 
name, and is passed to load_data( ). p is made to point to 
base, the starting point for the dataset, and is moved along 
the linked list as the loop progresses. If load_data( ) was not 
able to open the file, then a 0 is placed in the size field of the 
PLOT structure. When this happens, the program terminates. 
At the end of the loop, p->ne_t points to a new PLOT struc- 
ture. This means that there is one extra PLOT structure at the 
end of the linked list, tail points to this last structure as we 
leave the loop. Finally, the screen is redrawn and the program 
enters the main input loop, get—inputCinline). 

The dieC ) routine is called as the program is exited to 
free the memory which has been used by the program. The 
routine does this by following the linked list of PLOT struc- 
tures, freeing them as it goes along. The DATA structures 
which are associated with the PLOT structures are also freed. 

The rest of graph.c is fairly well commented, as are the 
other assodated modules. Remember that there is an extra 
PLOT structure at the end of the linked list; this structure is 
pointed to by tail. Some of the routines use PLOT structures, 
while others work only with arrays of structures. 

The graphing program could be made much more com- 
plex. You night try modifying the program to improve some 
areas. You could include the ability to draw bar charts and pie 
graphs, or consider adding axes and a means of saving data 
which has been changed or created. 

Program 6-2. graph.h 

/* 

* include file for the modules of the graph program 
*/ 

/* 

* plot modes which we can use 
*/ 

♦define NONE 0 

♦define DOT 1 

♦define UNE 2 

♦define DIHOM3 3 
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/* 

* some arbitrary constants 
*/ 

♦define IJNKTFN 1024 

♦define STYLE LINE 

♦define O0ICR WHITE 

♦define LEFD4 5 

♦define RIGHTM 5 

♦define TOHM 5 

♦define BOTTOMM 5 

/* 

* structure to hold the data being plotted 
V 

typedef struct { 
FLOAT x, 

y; 

} DATA; 



/* length of input line 

/* default style 

/* default color 

/* left margin 

/* right margin 

/* top margin 

/* bottom margin 



*/ 
V 
V 
V 

*/ 

V 
V 



/* 



* structure to hold information about a particular plot; we build 

* a linked list of these as we add more to the screen. The Program 

* follows the linked list of PLOT structures to redraw the screen. 
*/ 



typedef struct plot_s { 

struct plot_s *next; 
DATA *data; 

char filename [IJHELEN] ; 
int size; 
SHORT color; 
int style; 
} PLOT; 



/* pointer to next plot */ 

/* pointer to array of data */ 

/* name of the data file */ 

/* number of data points */ 

/* color to do the plot in */ 

/* style of line drawing to use */ 



/* 

* data regarding the particular display 
V 

typedef struct 



F1QAT 



int 

) DISPLAY; 



( 

xscale, 
yscale, 
minx, 
miny, 
xoff, 
yoff ; 
scaled; 



/* how much to scale x coord */ 

/* how much to scale y coord */ 

/* smallest x */ 

/* smallest y */ 

/* center of screen in X */ 

/* center of screen in y */ 

/* has the screen been scaled? */ 



/* 

* define these, so the compiler knows what they are going 

* to return. Each module (in theory) needs to have access 

* to at least some of these routines 
*/ 

extern void handle_plot() , load_data() , helpO ; 

extern void semilogO, log_log(), clear_screen() , g_status() 

extern DATA *fit(), *alloc_data ( ) ; 



Program 6-3. graph.c 

/ * graph.c - simple graphing program using the graphics library. 

* The program can plot data in a limited number of modes and 

* colors. It can draw the data as it would appear on log-log 

* or semi-log paper and it can do least-square curve fitting. 
V 
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/* 

* change the oolor of the requested dataset; find the dataset 

* which warts a new color, and then pass a pointer to that 

* PIOT structure along with the name of the new color to 

* set_color(). redrawf) the screen. 
*/ 

case 'c' : 

if ((p = find_data (dataset)) - NULL) break; 
set_color(p, param) ; redraw() ; break; 

/* 

* try to do a least square data fit using the requested 

* dataset, and name the fitted data the name entered as 

* the secord argument. First, check to make sure that 

* the user typed a second argument. Then find the dataset 

* the user wants to fit, and pass the appropriate information 

* to the fat() routine. Notice that we're already setting 

* up the new PLOT structure (remember, tail points to an" 

* allocated PLOT structure) . Then copy in the name of the 

* new PIOT structure, and allocate a new PLOT structure. Notice 

* how a nev tail is formed, and linked into the list all in 

* one program line. Redraw the screen. 
V 

case 'f ' : 

if (!*param) { 

printf ("Need to specify fitted data set name\n") 
break; 

if ((p = find_data (dataset) ) — NULL) break; 

tail-xSata = fit(p->data, tail->size = p->size) ; 

strcpy(tail->filename, param) ; 

tail = tail->next = alloc_plot() ; redraw () ; 

break; 

/* 

* the user is asking for help 
V 

case 'h' : 
case '?' : 

help (dataset) ; break; 

/* 

* convert the named dataset into log-log data; find the requested 

* dataset in the linked list, and then pass log_log() the a pointer 

* to the dsta, and the number of data points. Redraw the screen. 
V 

case '1 ' : 

if ((p - find_data (dataset)) = NULL) break; 
log_log(p->data, p->size) ; redraw () ; 
break; 

/* 

* change tie graphing mode of the named data set to the 

* mode specified in the second argument. Find the requested 

* dataset, and then call set_style() to change the mode of that 

* particular dataset. 
V 

case 'm' : 

if ((p = find_data (dataset)) = NULL) break; 
set_style(p, param) ; redraw () ; break; 

/* 

* redraw tie screen 
V 

case 'n' : 

redrawO ; break; 
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/* 

* leave the program 
V 

case 'q' : 

return 0; 

7 * read in a new dataset from the named file. The name of the file 

* becomes the name of the new dataset. Read in the new dataset 

* using the load data() routine. Remember, tail already points 

* to a valid PLOT structure, tail is reassigned to point to 

* a new PLOT structure after the data has been read in. Notice 

* that we can chain in the new PIOT structure AND move tail to 

* point to the last PLOT structure in one line. Force a redrawn . 

V 

case 'r 1 : 

load_data (dataset, tail) ; 

tail = tail->next = alloc _plot() ; 

redraw() ; break; 

'** convert the data into a semi-log plot; find the requested data 

* set in the linked list, and pass a pointer to the actual data 

* and the size of the data set to the semi_log() function, then 

* force a redrawf) of the screen. 
*/ 

<=aSe S if ((p - find_data (dataset)) = NULL) break; 
semi_log(p->data, p->size) ; redraw () ; 
break; 

/* 

* print out the status of the program 
*/ 

case 'v' : 

g_status() ; 
status () ; break; 

/* 

* a blank line was typed, ignore it 
*/ 

case '\0': 

break; 

/* 

* a command that wasn't understood was entered, so print 

* an error message, including the name of the command 

* which was typed 
*/ 

default: 

printf ("Bad command \»%s\".\n", command); break; 

) 

return 1; 



redraw the plots on the screen. Start by clearing the 

screen and resetting some of the plotting functions. 

Then, follow the linked list of PLOT structures, drawing eacji one. 



V 

static void redraw () 

( 

PIOT *p; 



clear () ; 
reset_screen() ; 
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(x)axAqss* rop oxqBqs 
A 

•uauq. oq saaquxod DUTirmqaa * 
sx pus 'a:rau«au]DS Aeme sfiux:rqs asaqq pajoqs scq oaxxdmoo * 
aqq qsxtq sx fiuxuaddBU. Axxraa SiqEUft isbuxxqs buxurnqai aq * 
oq uraas aft qsqq aoxqoN " ()iWT»s b uqxft op ubo aw 'auo sxuq. * 
.'ucrqeoxjTDads axAqs fiux:rqs B oqux uoxqBOXjxoads axAqs oxaaumu B * 
qjaAUOo 'spaoft jauqo ux .' OaxAqsx jo uoxqounj quauexotooo ana. * 

*/ 

( 

.'T- uirtqai 

.'(auxxux '„u\(s%) axAqs 6uxudBa6 pEgJjquxad asxa 
■'ONCireia uanqaj (o = (uPJoaiExp,, 'auxxux)otojqs) jx asxa 



'■3KC1 umqaa (o = (i,auxXn 'auxTux)ducxrqs) jx asxa 
•'loa amqai (o — Uqop,, 'auxxuxjctojqs) jx asxa 
!3im uirvqai (o = (..auou,, 'auxTUX)ducoqs) jx 

> 

.'auxxux* JEip 
(auxTux)axAqsx qux oxqEqs 
/* 

■asEO ipsa ipaqp oq auxqnca * 
Oducuqs aqq XT^o oq aABq aft asriBoaq ()tpqx«s e ¥ 
qqxft auop aq q.ireo sxxn -uoxqBoxjxoads axAqs * 
oxoaiunu s oqux uoxqEoxjxoads ax^qs renqxaq e qjaAuoo » 

»/ 

{ 

.' ( (axAqs<-d) axAqss 'auiBuaxxj<-d 
'ii«A*u\s%„\ oq „\s%„\ jo axAqs qas„)jquxad 
.'axAqsftau = axAqs<^3 (x- =; ( (auxxux )axAqsx = axAqswau)) jx 

.'axAqsftau qux 

) 

.'auxxux* jEtp 

(auxxux 'd)axAqs qas pxoA oxqsqs 

' /* 

•aXAqs paxjxoads auq jo ..aaqumu,, auq qa6 oq (JaxAqsx * 
XXra .'ainqoruqs joxd paxjxoads auq aoj axAqs axxqdai6 auq qas * 

*/ 



( 

( 

.' ( (axAqs<-d)axAqss ' (Joxoo<-d) joxoos 
'iiU\i.\s%«\ axAqs pus „\s%„\ jtoxoo uxq\„) jquxjd 
!(i.S„ : „„ ;t = azxs<-d 'azxs<-d'„u\-s%quxod p%q\„J jquxad 
; (auiBuaxxj<-d \,u\s% :qas Eqsp,,) jquxad 

) (qxau<-d = d ;qxau<-d .'asEcps = d) joj 

( 

.'rnnqaa 

•' (.iU\papBOX sqas sqsp on„)jquxjd 

) (azxs-asEq;) jx 

A 

qaA sqascqsp AN¥ papEOX q.uaABq a« uauq 'caaz sx azxs-aseq jx * 

' »/ 

-'dV imz 

) 

Osnqsqs pxoA oxqsqs 
A 

•ajnqonxqs ipsa * 

ux uoxqEuuojux quauxqaad auq. qno quxad puE 'samqoruqs * 
JOT3 jo qsxx ps&tUTT 3l W «OTT°? .'qaodai srvqcqs E qno qux^d ♦ 

*/ 

( 

.' (dJqoxoTaxpueij 
(qxau<-d = d ;qxau<-d .'asEcps = d ) joj 

A 

auo qeuq. uqxft fiuxuaAUB op o^ quew q.uop aft * 
• (XT^l M oq paquxod auo auq. '-a-x) qsxx pa>("TT ux qasEqep * 
qsBT aqq qB fiurquxod sx'd uaqq 'TTfW sx qxau<-d uau« ♦ 

»/ 
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/* . . 

* Hie complement of icolor() ; convert a numeric color specification 

* into atectual color specification. See notes with istyle() . 

V 

static char *scolor(i) 
int i; 

{ 

switcl (i) { 

case WHITE: return "white"; break; 
case BLACK: return "black"; break; 
case RED: return "red"; break; 

case GREEN: return "green"; break; 
case BLUE: return "blue"; break; 

case CYAN: return "cyan"; break; 

case YELLOW: return "yellow"; break; 
case MAGENTA: return "magenta"; break; 
default: return "unknown"; break; 



/* 

* allocate a PLOT structure and set some of the fields to 

* the default parameters. 

V 

static PLOT *alloc_plot ( ) 

{ 

plot *p; 

if (Cp = (PLOT *) malloc(sizeof(FLOT))) = NULL) 

die ("Unable to allocate memory for plot structure\n" ) ; 
p->ccLor = COLOR; 
p->stfle = STYLE; 
p->sise = 0; 
p->nect = NULL; 
p->daa = NULL; 
* (p->Eilename) = '\0'; 
return p; 

) 

/* 

* a utility function to find a particular dataset m the 

* linked list of datasets. Makes use of the globally defined 

* "base" cE the linked list. It uses strcmpO to compare 

* the requited dataset name with the names of the datasets 

* in the linked list. If the dataset couldn't be found, 

* find_dafct() prints an error message and returns NULL. 
V 

static FLOT*find_data(c) 
char *c; 

( 

regiser PLOT *p; 

if (!*c) ( 

printf ("No data set specif ied\n") ; 
return NULL; 

) 

for (p = Sbase; p->next; p = p->next) 

if (strcmp(p->filename, c) = 0) return p; 
printE("data set \"%s\" not found. \n", c) ; 
return NULL; 



- - ■ - ■ f , 
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Program 6-4. fileio.c 

/* 

* this module takes care of reading data in from a file 
V 

# include <stdio.h> 
# include "machine. h" 
((include "graph. h" 

/* 

* load data from the specified file into the PLOT structure 

* pointed to by p 
V 

void load_data (filename, p) 

char *filename; /* name of the file to open */ 

PLOT *p; /* a pointer to PLOT structure */ 

FILE *infile, *fopen() ; /* file pointer */ 

register int i; /* counter */ 

float tx, ty; /* floats to read in values */ 

/* 

* try to open the file for reading 

V 

if ((infile = fopen( filename, "r")) == NULL) ( 

/* 

* unsuccessful, print an error message 

V 

printf ("Unable to open %s\n", filename); 

p->size = -1; /* set to an unlikely value */ 

return; 

) 

/* 

* set the name of the data set 
*/ 

strcpy(p->filename, filename) ; 

/* 

* if we're using the same structure again, first free the old memory 
V 

if (p->data) free(p->data) ; 

/* 

* read in some key values 
V 

fscanf (infile, "%d", &p->size) ; 

/* 

* allocate a new data structure of the right size 
V 

p->data = allcc_data (p->size) ; , 

/* 

* scanf () functions return the number of fields they were able to 

* fill from the input line. Thus, fscanf () should always return 2. 
V 

for (i = 0; i < p->size; i++) ( /* read in data points */ 
if (fscanf (infile, "%f%f", &tx, Sty) != 2) ( 
printf ("Bad data point (%d)\n", i) ; 
f close( infile) ; 
p->size = -1; 
return; 

) 

p->data[i] .x = tx; 
p->data[i] .y = ty; 
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(azxs 'p)qxi, YIOT 
A 

•sanxBA x uaAxS aqq upqBui oq sanTBA A * 
sir puxi oq auxx e aoj uoxqBnba aqq asn train. .'aAino * 
qxj qsaq aqq puxi oq. uoxssaaSaj: :reauxx saienbs-qsBax asn » 

*/ 

( 

{ 

;(A-[x]p (axqnop) )£ox = A-[x]p 
;(x-[x]p (axcpop) )6ot=x-[t]p 

) (++T .'3215 > T .'0 = X) JOJ 

A 

■sanxBA A pus x aqq qqoq jo 6ox aqq 3^ «°" * 

*/ 

{ 

( 

;( u u\aAxqE6au ao coaz sr A jo x auios„)iqux;id 

} (0"0 => Aq, | | 0-0 => xq) JT 
.'A-[x]p = Aq !X-[T]p = xq 

A 

£mq punocre qa6 oq saxqetJEA duraq asn ♦ 

*/ 

} (++T .'aZTS > T .'0 = T) XOJ. 

A 

sanxBA A puB x aqq qqoq 30 * 
Box aqq axsq ubd a« sans &rp(Bui 'aouo Bqsp aqq q&naxqq una * 

*/ 

icqep aaaqq sx */ .'uonqai (p,) ix 

/ f sduraq */ .'Aq 'xq iTOTi oaqsx&ai 

jraqunco */ -T W 

:azxs qux 
_-'P* VIM 
(azts 'p)£ox 6°T P"Coa 
A 

sfiox oq sanxeA A aqq pub x aqq W q-iaAUoo * 

»/ 

{ 

.'(A-[x]p (axqnop) )6ox = A-[x]p (++T - 3Z TS >T -'0 = T) 

A 

-s5ox oqux pauonq aq ubo squxod * 
B3=p aqq 30 auos Axuo ix paqdruaoo buxaq uicai sqep aqq aqq sdaa>{ * 
scbox o«q aqq BuxqBOBdas -BqBp aqq 30 Box aqq axsq Axxbtqob «ou * 

*/ 

{ 

.'mnqaa 

; ( n u\aAxqB6au 30 ooaz sx A aujosjjquxad 

) (o-0 => A-[T]p) IT 

(++T iazxs >x .'0 = x) aoj 

A 

AqTUTjut aAxqebau sx 0 30 ()£>°T a^B P"^ 'paurjapun sx oaquinu * 
aAxqafiau b 30 ()6ox aqq aouxs ' ()£ox qqxrt usn yxan q,uop * 
asaiu, -o ao aAxqB&au J03 £up{Oox 'aouo sqcp aqq qonoaqq uai * 

*/ 



sdanioruis 



/, Bqsp passed aa,a« 3T ^ao« Axuo */ ;uonqa.i (p;) JT 

, jaqunoo */ -'T W 

A ) 

.'azxs qux 
.'P* Viva 
(azxs 'p)6ox xuras pxoA 
A 

auo T B s.x auq aABax PUB 'sfcox oq saqeuxpaooo A a^q 30 TT b qoaAUOo ^ 

: ()qabs axqnop uiaqxa 
: ()6ox axqnop uoaqxa 
A 

squx umqaa Aauq Wtq q.usaop Jcai T duioo aqq os asaqq auxjap ^ 

..q-qdsjb,, apnxouxjf 
..q-auxqoBui,, apnxoux# 
<q-oxpqs> apnxoux# 

A 

•Axq^a^ 00 aXT 051100 * 

qou XXTW uoxssaadxa aqq qeqq aJB saouBqo uaqq 'sqBO T J paqdx^qns » 
a^'ao cq sBq uoxssaadxa ub 3 x '^a T xduiDO sxqq ^apun ^upt^ * 
aoCBUt paaxnbaa 6nq qBOXJ-P^dTaosqns aaxxduioo oaqzv b6xw auq BuxpiOAV * 

•suoxsaaAuoo fiox pub * 
Buxqqxi aAjro aqq op oq sarnpom uqsui aqq jo xte SBq o-qqem * 

o-qjBUi -g-9 iubj3oj,j 

{ 

/, Ab^b aqq oq ^aquxod b »/ -° ^« 

i (TiriN) axp 

r (azxs \,u\(p%) Abo^ Bqsp aqBOoxxB oq axqeua,)3quxJ<J 

' ) (TlflN = (((ULWJJ^ZTS * 3ZTs)mt|OT^(»^ = &j 

A 

• ()axp qfencaqq qno sxxBq uiaafioad aqq 'sxxbj ()oo T x™ JI * 
•paqeniBAa aq aaAau i T x« qx ux Qootxbui «a W« uoxssaadxa aqq * 
anoTsx 0 => «ts) jx 'oaq.iauraa -azxs P x T ba b aABU a« aons a^Bui ¥ 
oq^aqo Jazxs qqfixa aqq jo Aaou^u 3 o >poxq B qa6 oq (}ooxx™ XI^o ^ 

.'b* visa 

) 

.'azxs qux 
(azxsjBqep^ooxXB* VIM] 
A 

.' Oooxxbo pasn aABq pxnoo aM '^xs paqsanbaa * 
aqq jo samqoxuqs «KI JO Abiib ub sa^BOOXTB uoxqounj sxyq ^ 

{ 

(axxjuxjasoxoj 
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int size; 

( 

DATA «f; 

FLOAT sxy = 0.0, sx = 0.0, sy = 0.0, sxs = 0.0, sys = 0.0; 
FLOAT m, b, tx, ty, t; 
int i; 

/* 

* cheek to make sure we have enough data points. Lt's hard to find the 

* best fit line if you only have one point to work with. 

V 

if (size < 2) return NULL; 

/* 

* allocate a new array of DATA structures to hold the best fit 

* line. 
V 

if ((i = allocdata(size)) = NULL) return NULL; 

/* 

* Now the real work begins: find the sum of the x's, sum of the y's, sum 

* of the x squared, the sum of the y squared, and the sum of the xy 

* products. 
V 

for (i = 0; i < size; { 

tx = d[i] .x; ty = d[i] .y; 

sx += tx; 

sy += ty; 

sxs += tx * tx; 

sys +<= ty * ty; 

sxy 4= tx * ty; 

} 

/* 

* use the values we've just calculated to find the best fit line: 
* 

* The slope is found using the relationship: 
* 

* n * sum(xy) - sum(x) * sum(y) 

* slope = — 

* n * sum(x squared) - (sum(x)) squared 
* 

* and the intercept is given by: 
* 

* sum(y) * sum(x squared) - sum(x) * sum(xy) 

* intercept = 

* n * sum (x squared) - (sum(x)) squared 
* 

* where n is the number of data points 
V 

t = 1 / (size * sxs - sx * sx) ; 
Ei = (size * sxy - sx * sy) * t; 
b = (sy * sxs - sx * sxy) * t; 

/* 

* print out the best fit line 
*/ 

printf("best fit line : y - %fx + %f\n", (float) m, (float) b) ; 

/* 

* print out some other "interesting" data 
*/ 

printff "Average values : (%f,%f)\n", 

(float) (sx/size), (float) (sy/size) ) ; 

/* 

* The standard deviation of the x and y values tell you how well the 

* data poiits cluster around the average values. If you're doing 
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* experimental work, you'd generally take the same measurement several 

* times and report the average value plus or minus some uncertainty 

* (due to experimental error, faulty equipment, etc.). The 

* standard deviation tells you what that uncertainty ought to be. Thus 

* you'd probably report: 
* 

* (average value) +/" (standard deviation) 
* 

* Where the standard deviation is calculated with: 
* , 

* / n * sum(x squared) - sum(x) squared 

* s = V 

* n * (n - 1) 
* 

* where n is the number of data points. The standard deviation of 

* y was found by replacing all of the x's in the equation with y's. 

V 

t = 1.0 / (float) ((size - 1) * size); 

tx = sqrt( (double) ((size * sxs - sx * sx) * t) ) ; 

ty = sqrt( (double) ((size * sys - sy * sy) * t) ) ; 

printf ("Standard Deviation: (%f,%f)\n", (float) tx, (float) ty) ; 

/* 

* calculate all of the data points for a line with the best fit slope 

* and intercept (use the standard y = mx + b formula for a line) 
V 

for (i = 0; i < size; l ++) ( 

tx = d[i].x; f[i].x = tx; 
f[i] .y = m * tx + b; 

) 

return f; 



Program 6-6. draw.c 

/* 

* this module of graph takes care of plotting data to the screen 
V 

/* 

* required include files 
V 

i include <stdio.h> 
((include "machine. h" 
#include "graph. h" 

/* 

* variable only defined in this module; holds all of the information 

* regarding what's being drawn on the screen. 
V 

static DISPLAY display; 
/* 

* define these functions so the compiler doesn't complain; make them 

* static so they are only defined in this module 

V 

static void range () , plot_data() ; 
static DATA *scale ( ) ; 
static int check (); 

/* 

* clear the screen and reset the scaling status variable 



((A- [TlP (W) 



(++T .'3ZTS > T .' ) OOJ 

( 

.'3(Bejq 

(jhohs) '3X (iacHS))aAaa 
• araTDrew = 'x-CtIp (w) = ^pOxaaqp) jt 

(++T '3ZT S > T •' 0 = T) 

:3NTI asso 
} (apom) uprrrts 
.'iLtrt^aa (p,) jt 

i^A '^X 'T ^LTT Oa^SXDaO 

} 

.'aporn }iri 

i3ZTS 3UX 

.'P* raw 

(apoui 'azTS 'p)B^ep ^OTd ptoa ojisis 

A 

•ooxoo qas-^SBi aiw sasn -pawnd 30U sr wod * 
aip uauq. '30U s,}T Jl -uaaoos ato. uo aq 03 &rro6 sr turrod Bq.ep * 
au} jx ass 04 Ospaip sxto -peauasaodao aq pxxicms b^bp aq} «oq * 
ass '04 apau rysxd sipaqo -uaaoos aqq. uo B}Bp am vxd AxistPOB * 

*/ 



s^Lrod B^Ep paxBos aio 03 oa^uxod b uorc;ao */ 



.'«au uorvaao 



.'jioA-AexdsTP + ^ = A-[t]abu 
.' aiBosA • AEidsxp ♦ (Auxoi-ABxdsTP - A-[x]p) = 3 
iijox-Aexdsxp + } = x-[Tl«3U 
axBosx * Aexdsxp * (xuxia-ABidsTP - x-[x]p) = 4 
} (++t -'azTs > x .'0 = 



T) -i°J 



A 

synod B4BP aio 10 XT 1 * axBos * 



{ 

!\ = paTBOS'AETdsXp 

.'Auxiu-AExdsTP - WiQl = JioA-ABxdsxp 
.'xuxurABxdsxp - ULU1 = jiox-ABxdsxp 
; (Auxui-Asxdsxp - Axem) / 
1 (WHDLIOa4WJOlj - 32TS A) toutt) = aTBOsA-ABXdsTP 

; (xuxui-ABxdsxp - xxra) / 
( (WUBIH+WL331) - SZTS X) (iWTLi) = aTBOSX-ABXdsxp 

{ 

■TIDH uorciao 

i („u\-A joxui uot^btjea ou„)i3,UTod 
} (Auxui-ABxdsxp = Axbui 1 1 xuxurABxdsxp = xxeu) it 
1 (AuxurAsidsxps 'xuxurABxdsxp'? 'Axeiirj 'xxbups 'azTs 'p)a£uei 

} (pexBos-ABXdsTPi) JT 

A 

p3}BTroiBoao 04 sanxBA }asijo pus Cuxibos aqq. saoooj uaaoos * 
aiQ ouxoeaxD -StiXTBOs aires ai» mx« uaaoos oruo vdaqoi* 
sqdBo5 Aubui snoxpa Vcuj, -AoEssaoau s,4T JT fiuTP»s opao Atuo * 



."TITOl uotqao (TITOl 



{(azTs)B^Bp ooxx^ = «au)) JT 
."Tirol uono,ao (Pi) JT 



'Axbui 'xxeui iroii 
.'T vrx J35st£si 



con 



(azTs 'pJaxBos,; yewI ox^b^s 

A 

•^asjjo puB fiuxTBos aures ayq. u^t« uaaoos » 
aif; uo paddBxaa/so aq o^ stffeifi xBiaAas s«oxTB stuj, -asxBj st pat^s * 
axqBTOBA aio. pauuojoad Axuo sx Buxxbos -punoiB XX^ sxaxxd 3ATJ jo * 
uxbiEm e tor* uaaoos aqq. jo sairxiuoo at*} utlrt« aAT^T 90 *^ ' aJB Aejjb ¥ 
q.n±ino aio. ux sanxBA am jo XX^ }bir os ^asjjo pire axBos b sa^BxnoTBO * 
uaio 41 -sanxBA A pus x ayq. jo a&rea ato puxj 04 ()a6uei sasn OaxBos * 

*/ 



{ 

{ 

.'^(Baiq 

.' (aureuaxTJ<-P 
'hU\ , h\s%„\ aoj apcui Emfloid UMouj(ua,)i4UTod 

:^TTiBiap 

A 

wxre rtoux art EtmRaiuDS 04 axAjs atfi , 
^as puB a6essaui ioug ub q.uxj<j -apooi fiutwid u«oui(un * 

*/ 

.'XBaiq 
.' (^oxdcq^aaaj 
.' (axAq.s<-p 'azxs<-p '4oxdoq.)B4Bp 30x<3 
.'Uoioo<-p (JMCHS) )uad~4as 
; (azxs<-p 'B^Bp<-p)axBos = :y3ida} 

•aNTT asBO 
:rofCWVia asBO 
:,IjQa asBO 

A 

s^Lrrod e^Bp paxBos ai^ fiuxpxoq * 
Aexie am^onj^s VIWI au^. ()aaij pub '^oxd 'axBos 'asaiR jo Aub joj ♦ 

»/ 

.'jfBaoq 

.' (auiBuaxTJ<-P '..uVpa^Xd 5QU 11 \s% 11 \„)i4urad 

:aN0N asBO 

A 

^as sb« apoui ou * 
*/ 

) (aX'tl.s<-p) ucqxrts 
;uirv4aa (B^Bp<-p;) JT 

A 

b^bp s.aoau} it ^°Td 04 Axi Atuo * 

»/ 

.'^oxdo^f yiw: 

) 

•'P* lOTd 
(pJ^ox^aTPUBtt PXOA 
A 

sapom 6uTq.5oxd axqT ssod stioxjba am aoj uox^ob a^BXJdcaddB aj(Bi * 

*/ 

/* axBos XXT" W<J ^sxti ,/ .'0 = paxBos-AexdsTP 

} 

() uaaoos ^asao pxoA 
A 
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if (checkfxt = (int) d[i].x, yt = MWOZNE - (int) d[i].y)) 
draw( (SHORT) xt, (SHORT) yt) ; 

break; 
DOT: 

for (: = 0 ; i < size; i-H-) 

if (check(xt = (int) d[i].x, yt = MA5CLINE - (int) d[i].y)) 
plot ( (SHORT) Xt, (SHORT) yt) ; 

break ; 
case DIAMOND: 

for (i = 0 ; i < size; i++) 

if (checkfxt = (int) d[i].x, 

yt = MAXLTNE - (int) d[i].y)) ( 

move( (SHORT) xt, (SHORT) (yt + 2)); 

draw( (SHORT) xt - 2, (SHORT) yt) ; 

draw( (SHORT) xt, (SHORT) (yt-2)); 

draw( (SHORT) xt + 2, (SHORT) yt) ; 

draw( (SHORT) xt, (SHORT) (yt+2)); 

) 

break; 

) 

} 

/* 

* check to see if a data point is going to be on the screen 
V 

static int ckeck(x, y) 
register intx, y; 

{ 

if (x ( 0 || x >= x_size | | y < 0 | | y >= y_size) 
return 0; 

else 

return 1; 

) 

/* 

* this routjie finds the range of the x and y so that the graph 

* can have laximum scaling 
V 

static void aange(d, size, maxx, maxy, minx, miny) 
register DAB. *d; 
register int size; 

register Ficar *maxx, *maxy, *minx, *miny; 

( 

register int i; 

if (!d; return; 

*maxx ■ *minx = d[0].x; 

*maxy = *miny = d[0] .y; 

for (i = 1; i < size; i++) ( 

if (*maxx < d[i].x) *maxx = d[i].x; 

if (*maxy < d[i] .y) *maxy = d[i] .y; 

if (*minx > d[i].x) *minx = d[i].x; 

if (*miny > d[i].y) *miny = d[i].y; 

) 



/* 

* print out the "status" of the plotting routines 

* this inclules the current offsets, scaling, and color 
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void g_status() 
( 

if (display. scaled) 

printf ("Offsets (%f,%f); Scaling (%f,%f)\n", 

(float) display. xoff, (float) display. yoff, 
(float) display. xscale, (float) display. yscale) ; 

else printf ("No scaling set\n") ; 

) 

Program 6-7. help.c 

/* 

* print a help module 
V 

/* 

* get definition of void in case the compiler doesn't support it 
*/ 

#include "machine. h" 

void help (inline) 
char *inline; 

( 

if (*inline = 'm' || *inline = 'M* ) ( 
printf ("Available graphing modes:\n"); 
printf ("none — don't allow plotting\n") ; 
printf ("dot — plot as dots\n") ; 
printf ("line — plot as lines\n") ; 
printf ("diamond — plot as diamonds\n") ; 

) 

else if (*inline = 'c' | | *inline = 'C') ( 
printf ("Colors available are:\n"); 

printf ("black, white, red, green, blue, cyan, yellow, and magenta\n") ; 
} 

else ( 

printf ("Available Commands: \n") ; 
printf ("c <dataset> <color> 
printf ("f <dataset> <dataset> 
printf ("h 

printf ("1 <dataset> 
printf ("m <dataset> <style> 
printf ("n 
printf ("q 
printf ("r <file> 
printf ("s <dataset> 
printf ("v 
) 

) 



Program 6-8. sine.c 

/* 

* Generate some data to play with for the graphing program; build 

* a sine wave with 100 data points. 
V 



— set the color\n") ; 

— do least-squares fitting on the data\n") ; 

— print this help list\n") ; 

— \"log\" the data (log both x and y)\n") ; 

— set the plotting mode\n") ; 

— clear and redraw the display\n") ; 

— quit\n") ; 

— read in another data file\n") ; 

— \"semi-log\" the data (log only the y)\n"); 

— print program status\n") ; 



# include <stdio.h> 
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So far we've been discussing the day-to-day graphics 
that many programmers use. In this chapter, we'll turn our at- 
tention to how graphics work. 

Computer graphics is one of the most fascinating aspects 
of the modern microcomputer. More and more, games,^ utili- 
ties, and even business packages employ the computer's abil- 
ity to dazzle and fascinate. As computers continue to grow in 
power and sophistication, powerful graphics which once were 
only available on dedicated graphics workstations are now 
available on personal computers. 

One facet of graphics is the computer's ability to mimic 
the real world with the illusion of depth and perspective. Ar- 
cade games have shown an increasing trend towards three di- 
mensions: first Battlezone, a perspective tank war; more 
recently, the Star Wars and Zaxxon video games, along with a 
variety of other fabulously realistic three-dimensional arcade 
simulations, with ever flashier illusions of perspective. 

Three-dimensional computer graphics is almost a world to 
itself in the computer field. Using mathematics only slightly 
more complex than most computing applications, you can pro- 
duce some amazing results on a computer screen. In the fol- 
lowing chapters, we will work through the elements of 
computer graphics, starting with some fundamentals, then 
moving on to more complex aspects of computer graphics. 

Raster Graphics 

Before you can draw anything, it's necessary to become famil- 
iar with the screen on which you will be drawing. All' micro- 
computers have essentially the same type of graphics display. 

The images on the screen are displayed as pixels, or pic- 
ture elements, which are small dots of color. The number of 
pixels a computer can display is an important factor in deter- 
mining the quality of its graphics; the more pixels on the dis- 
play surface, the better the image. Most microcomputers have 
a resolution of at least 320 X 200 pixels (measured horizon- 
tally and vertically). Many can support 640 X 200, though 
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line's slope is greater than 45 degrees. Another method is to 
make the function advance along the y-axis for steep lines, 
and add fractions to x. The program would check the slope of 
the line and decide whether to advance along x, adding frac- 
tions to y or advance along y, adding fractions to x. This may 
seem a little backwards, but it will become necessary as we 
speed up the lineC ) function. Program 7-2 is a revision of the 
line-drawing routine, lineC ) 

Program 7-2. Iine2.c 

# include "rachine.h" 
/* 

* Draw a line fran (xl,yl) to (X2,y2) 
*/ 

line(xl, yl, x2, y2) 
int xi, yl, x2, y2; 

float x = xl, y = yl, slope; 

int signx, sign_y; /* now we don't :just increment */ 

siqn_x = (x2 > xl) ? 1 : -1; 
si<jn_y = (y2 > yl) ? 1 : -1; 

if (sign_x * (x2-xl) > sign_y * (y2-yl) ) { /* is angle < 45? */ 
slope = (float) (y2 - yl) / (x2 - xl) ; 
while (xl != x2) { 

plot ( (SHORT) Xl, (SHORT) (y+.5)); 

xl += sign_x; 

y 4= slope * sign_x; 

) 

eise { /* reverse y and x and plot along the y axis */ 

slope = (float) (x2 - xl) / (y2 - yl) ; 

while (yl != y2) { /* loop through y, instead */ 

plot ( (SHORT) (X+.5), (SHORT) yl) ; 
yl sign_y; 
x += slope * sign_y; 

) 

) 

) 

Programmers using the ST without a command line inter- 
preter should add the following lines just before the last clos- 
ing curly brace at the end of the mainC ) function: 

printfC'Press RE TUMI to exit:"); 
getcharC ); 

Make su-e to include the line 'include <stdio.li>. 

Program 7-3 is a simple program that calls the lineC ) 
function, then uses the sinC ) and cosC ) functions to generate 
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360 "spokes" for a "wheel." The result is a surprisingly intri- 
cate, mandala-like shape. 

Program 7-3. mandala.c 

# include <stdio.h> 
# include "machine. h" 
double sin() , cos() ; 
#define PI 3.14159265359 



* Use our line() routine to draw 360 "spokes" of a wheel. 

V 
main() 

{ 

SHORT i; 
float len; 

init_graphics(CDIDRS) ; 

len = .8 * ((y_size < x_size) ? y_size/2 : x_size/2) ; 

setjen (WHITE) ; 

for (i = 0; i < 360; -H-i) 

line(x_size / 2, y_size / 2, 

(SHORT) (x_size/2 + len * cos (i / 180.0 * PI) ) , 
(SHORT) (y_size/2 + len * sin(i / 180.0 * PI) ) ) ; 

exit_graphics (NULL) ; 



Programmers using the ST without a command line inter- 
preter should add the following lines just before the last clos- 
ing curly brace at the end of the main( ) function: 

printfC'Press RBTTTR1T to exit:"); 
getcharC ); 

Make sure to include the line "include <stdio.h>. 

This simple line-drawing function is very slow. Floating- 
point math is not a simple operation for most computers. 
Speed considerations are extremely important in all graphics 
programs. Often, graphics programmers are forced to optimize 
their code to the extreme just so the program will work at all 
(as with flight-simulator programs, for example, which use the 
same techniques that we'll be developing in later chapters). 
We will not discuss the difficult methods for making code 
work as fast as possible at any price. Rather, you'll see some 
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Thus, wh«n the fraction variable becomes greater than ran, 
we add 1 to the y coordinate, and adjust the fractional part by 
subtracting rise from it. 

Our fourth (and last) version of line includes these im- 
provements (Program 7-5). To keep the function as short as 
possible, i: also has only one main loop, not two. Thus, we 
treat the x and y coordinates equivalently. To do this, we cal- 
culate the distance between xl and x2 (run) and between yl 
and y2 (rdse). The greater of the two becomes the numera- 
tor. The rales of yd and xd have been replaced with the vari- 
ables frac_y and frac_x. These are the numerator for the x 
and y fractions. Each time through the loop, we add run to 
frac_ x, aid if it's larger than numerator, we increment x, and 
subtract "\" from the denominator; we do likewise for y. If 
run equal; numerator (that is, if run was greater than rise 
when we assigned the numerator), x will be incremented ev- 
ery time tlrough the loop; if rise equals numerator, y will 
be incremented. (While we're using the word incremented, x 
or y may actually be either incremented or decremented dur- 
ing the loop.) The fractional parts of the variables are initial- 
ized to 0.5. This means that the fractions are rounded, rather 
than truncated, as we loop. Rounding in this way helps to 
give the line a more balanced and even look. 

Program 7-5. Iine4.c 

^include "maihine.h" 
/* 

* Draw a lijte from (xl,x2) to (yl,y2) losing only integer add and subtract. 

V 

line(xl, yl, x2, y2) 
register intxl, yl; 
int x2, y2; 

( 



register SHORT denominator; 


/* 


max of run, rise 


V 


register SHORT frac_x, frac_y; 


/* 


fractional component of x,y pos 


*/ 


register SHORT i; 


/* 


counter for point-plotting 


*/ 


register SHORT run, rise; 


/* 


x, y distance from start to end 


V 


register SHORT sign_x, sign_y; 


/* 


x, y direction from xl,yl 


V 


run = x2 - xl; 


/* 


break down distance from xl to 


V 


if (run > 0) sign_x = 1; 


/* 


x2 into two parts, the absolute 


V 


else { 


/* 


value "run" and the sign value 


V 


sign_x = -1; 


/* 


"sign_x". 


V 


run = -run; 

} 








rise= y2 - yl; 


/* 


break down vertical distance 


*/ 


if (rise > 0) sign_y = 1; 


/* 


into similar components "rise" 


V 


else ( 


/* 


and "sign_y". 


V 
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sign_y = -1; 
rise = -rise; 



} 



/* for our rise/run or run/rise calculations, we need to choose the */ 
/* greater of "rise" and "run" as the derraninator of our fractions. */ 
/* We then initialize the fractional components to .5 by setting */ 
/* them to half the value of the denominator. */ 



denominator = (rise > run) ? rise : run; 
frac_y = frac_x = denominator » 1; 



/* divide by two */ 



/* In the main loop we loop "denominator" times (advancing along */ 
/* either "rise" or "run") , plotting (xl,yl) and adding frac_x and */ 
/* frac_y to the x and y components. */ 



for (i 



if — i) { 



= denominator; 
plot(xl, yl); 
if ((fracx -t= run) > denominator) 
frac_x — « denominator; 
xl += sign_x; 

) 

if ((frac_y +■= rise) > derottinator) 
frac_y — denominator; 
yl += sign_y; 

) 



frac overflows? 
decrement frac 
increment x 



( /* likewise for y */ 



It's instructive to compare the differences among these 
functions. When the Lattice C compiler was used on the 
Amiga, for example, a sample test program took over a minute 
and a half using the floating-point line function; 14 seconds 
with integer divide; and only 6 seconds with pure integer 
math. However, let's rewrite the lineC ) function to use the 
Amiga's built-in line-drawing capabilities, Program 7-6. 

Program 7-6. lineS.c 

♦include "machine. h" 
/* 

* Draw a line from (xl,yl) to (x2,y2) using system primitives. 
V 

line(xl, yl, x2, y2) 
int xl, yl, x2, y2; 

{ 

movefxl, yl) ; /* use the routines from machine. c instead */ 

draw(x2, y2) ; 

} 

Now the mandala program takes only 2/10 second. 

This dramatic increase in speed demonstrates one point to 
remember when using a complex operating system: Calling a 
single system routine can often take longer to execute than all 
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to black. Thus, for the 2 X 2 dither matrix, you can have 5 in- 
tensities, 0-4. 

Keep clear in your mind the difference between dithering 
and patterning. With patterning, we reduce the resolution and 
then plot "big pixels" on the screen. Dithering, on the other 
hand, uses the same resolution as the screen itself. The inten- 
sity can change from pixel to pixel, and the dither matrix re- 
flects this: If we increase the intensity of a given area of the 
screen, more and more pixels will turn on as their intensity 
becomes greater than the dither-matrix value at that point. 

Larger dither matrices are often used, particularly the 4 X 
4 and 8X8. Larger matrices are formed from smaller ones re- 
cursively; to generate a matrix of size n X n, put the matrix of 
size n/2 X n/2, but with every number multiplied by 4, in 
the top left corner; the same matrix, but with 1 added to every 
value, in the bottom right corner; the matrix plus 2 in the up- 
per right; and the matrix plus 3 in the lower left. 

n _ /4D(„/ 2 ) 4D( H /2) + 2\ 

U " \4D(„/2) + 3 4D(„/ 2 ) + 1/ 

For example, the 4 X 4 matrix that's derived from the 2 
X 2 matrix above is 

(C 8 2 10 \ 

12 4 14 6 ) 

3 11 1 9 J 

15 7 13 5 / 

In mechine.c, we used a 4 X 4 dither matrix to generate 
17 intensities; we could have used an 8 X 8 matrix, but 17 
shades of grey are adequate. When we plot a point at a given 
x,y location, it is easiest to modify the x,y coordinates to be 
within the dither matrix; for a 4 X 4 matrix, you would examine 
the dither-value at location (x % 4, y % 4) in the dither array. 
(In fact, you would normally use (x & 3, y & 3) to take advan- 
tage of the much greater speed of bitwise logical operations.) 

In the next chapter we will take up the issue of filling 
large areas with color, the first step to genuine three-dimensional 
graphics. 
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On most machines, the computer can be seen slowly fill- 
ing the interior of the shape line by line or pixel by pixel. But 
even on the faster machines, a seed fill still takes a significant 
amount of time. This method is generally avoided by serious 
graphics programmers. Its one advantage is the ability to fill 
arbitrary areas. In this book, we won't be exploring the seed 
fill in much detail. 

Scan-Line Fill 

Scan-line fill routines accept a list of edges and then draw the 
polygon that the edges define. The algorithm to perform the 
fill is quite simple: Start at the top of the screen (pixel row 0) 
and proceed to the bottom; for each row compute which of 
the polygon's edges intersect the screen as well as where they 
intersect. Then draw lines connecting each pair of intersections 
together, arid you have a filled polygon (Figure 8-1). 

Figure 8-1. A Polygon Filled with Scan Lines 
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Polygon Filling 



Users of AmigaBASIC may have used the AREA and 
AREAFILL commands, and experienced Amiga C program- 
mers may have explored the AreaMove( ), AreaDraw( ), and 

AreaEndC ) functions already. These functions control the 
scan-line fill routines that the Amiga's graphics coprocessor 
provides. The Atari also provides a built-in scan-line fill func- 
tion, called v_fillarea( ). It is, however, executed by the 
microprocessor itself, not by a coprocessor chip, and thus is 
somewhat slower than the Amiga's AreaFill routines. 

Let's consider a simple example, a triangle with vertices at 
(100,50), (200,100), and (150,150)— Figure 8-2. When we exam- 
ine pixel row 0, we find that none of the triangle's edges inter- 
sects that row, so we go on to the next. When we reach row 
50, we find that two edges intersect the scan line: the top ends 
of the two lines (100,50)-(200,100) and (100,50)-(150,150). 
Calculating their intersections with row 50 gives us (not sur- 
prisingly) 100 for both lines. Drawing a line from (100,50) to 
(100,50) gives us the single point at the top of the triangle. 

Figure 8-2. Before a Scan-Line Fill 



(100,50) 




(200,100) 



(150,150) 



As' we continue to scan down the screen, the intersections 
of the two lines diverge, until finally at row 99 we're filling in 
pixels on the scan line from 125 to 200. When we get to row 
100 we find that a different pair of edges is intersecting with 
the scan line: (100,50)-(150,150) still intersects, but now the 
right-hand edge of the polygon consists of the line 
(200,100)-(150,150); see Figures 8-3 and 8-4. 
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values precede higher ones. To draw the image, all we have to 
do is pull pairs of points off the list, and draw lines between 
them. When this ordered edge list is empty, the polygon is 
drawn. 

A certain amount of work has to be done to keep the list 
consistent, however. For example, horizontal edges are thrown 
away altogether; they're not needed, since the top or bottom 
of a polygon will be defined by that polygon's filled interior 
anyway Furthermore, we have to examine the output of the 
line function to insure that each polygon edge produces only 
one intersection per scan line. For nearly horizontal lines, the 
line routine produces many pixels on one scan line. We can 
either throw away these extraneous pixels, or rewrite the line 
routine so that it always increments or decrements y each time 
through the loop. We'll be using the latter alternative in our 
programs. 

Another problem occurs at the vertices of the polygon. 
When two edges intersect at the top or bottom of a polygon (a 
local maximum or minimum), both generate an intersection 
point. Then, when we display the polygon, we draw a one- 
pixel lire connecting the two identical points. 

However, when two edges intersect on the side of a poly- 
gon (nol a local maximum or minimum), a problem arises: For 
one scan line there are two edges on one side of the polygon. 
Countirg the polygon's other edge, this means that there are 
three intersections on this scan line (see Figure 8-6). 

Figure S-6. Three Intersections on One Scan Line 




two edges 
at right 



Since our algorithm pulls points off the intersection list in 
pairs, an odd number of intersections creates a great deal of 
difficulty. 
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Polygon Filling 



Consider the polygon with vertices at (2,1), (7,3),^ and 
(4 6). The two lines (2,l)-(7,3) and (7,3)-(4,6) intersect at (7,3), 
o on scan line y = 3 the polygon has two right-hand edges^ 
The easiest fix for this problem is to shorten one of the edges 
slightly: In this case, we might start the line that goes from 
(7,3) to (4,6) one scan line further down, at (6,4); see Figure 8-7. 

Figure 8-7. Adjusting a Polygon's Edge 

x position 



1 2 3 4 5 6 7 8 




The other two intersections, at (2,1) and at (4,6), are, re- 
spectively, a maximum and a minimum point on the polygon, 
o we don't need to shorten any edges to make them work out. 

Let's examine what happens when we apply the algorithm 
to the sample triangle above. First, we run the line routine on 
the three lines defied by the three vertices to generate the list 
of intersection points. Remember, we only want ^mtersec- 
tion per scan line from each polygon edge. Also, we . need to 
shorten the edge from (7,3) to (4,6) to avoid incorrect intersec- 
tions. This gives us the following list of points (Figure 8-8). 

for (2,l)-(7,3): (3,1), (5,2), (7,3) 
for (7,3)-(4,6): (6,4), (5,5), (4,6) 
for (4,6)-<2,l): (4,6), (4,5), (3,4), (3,3), (2,2), (2,1) 
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Figure 8-10. Upper and Lower Vertex 




upper 
vertex 



Figure 8-11. Removing an Edge 




^ deleted edge structure 

scan line, and remove those edges whose length has become 0 
(Figure 8-11). 

Cne step that might appear somewhat slow at first glance 
is to sort the list by y coordinate. In fact, it's possible to do 
this v?ry quickly. We can set up an array with one component 
for every scan line on the screen; thus, for a 200-line screen 
we make an array of 200 elements. Then, to sort the list, we 
just check the line's upper vertex, and put it in the array ' ele- 
ment with the appropriate y coordinate. So, a line from (2U,1U) 
to (5C100) would be placed in element 10 of this scan line 
array. 
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One small modification is necessary, however, since more 
than one line can be placed in a single bucket, or array ele- 
ment (consider the two lines at the top of our triangle from 
the last example). To allow for this, the array consists of point- 
ers to edge structures. To add an edge to a given bucket, we 
make that bucket's pointer point to the new edge.Then the 
next-edge pointer points to the new edge, which is what the 
bucket used to point to. In effect, we insert the new edge at 
the head of the edge list for the appropriate bucket. 

With this scan-line array pointing to lists of edges, it be- 
comes very simple to add new edges to the active-edge list 
when we actually display the screen. When we advance to a 
new scan line, we simply make the end of the active-edge list 
point to the beginning of the list attached to the appropriate 
bucket. Deleting an edge (when its length becomes 0) is simply 
a matter of freeing the edge structure and juggling pointers. 

poly.c 

Now that you have an understanding of area fill, type in Pro- 
gram 8-1, polygon.c. When you have compiled and linked it 
correctly, type in the two data files accompanying the pro- 
gram, poly.l and poly.2 (Programs 8-2 and 8-3). To see the 
program in action, type polygon poly.l or polygon poly.2 on 
the Amiga, or, on the Atari, change the name of the program 
to polygon. ttp, and install it as a TOS-takes-parameters pro- 
gram; then double-click POLYGrON.TTP and type poly.l or 
poly.2 as arguments in the dialog window, poly.l contains a 
few sample polygons; poly.2 contains polygons defining a 
shaded cone. 



Program 8-1. polygon.c 

/* 

* This program displays filled polygons. Input is from a file (specified 

* on the command line) containing polygon descriptions. 
V 

# include <stdio.h> 
# include "machine. h" 

char *get_item() ; /* routine to do malice */ 

void area_move(), area_draw() , area_end() ; /* polygon draw routines */ 

main(argc, argv) 
int argc; 
char **argv; 

{ 

SHORT i, /* polygon vertex counter */ 
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* going in the same direction as the previous line, and if so we shorten 

* it by a scanline and tamper with the beginning or end of the line. 
*/ 

void area draw (bx, by) 
register SHORT bx, by; 

{ 

static SHORT delta_y = 0; /* 0 if (by-ay) > 0, else 1 */ 

lagister edge *new; /* pointer to edge being created */ 

register SHORT ax = pos.x, ay - pos.y; /* beginning of line */ 
register SHORT temp; /* variable to allow us to swap */ 

register SHORT old_delta = delta_y; /* save old value of delta_y */ 

rps.x = bx; /* save the new position! */ 
pos.y «= by; 

if (ay = by) return; /* ignore horizontal lines */ 

calta_y = (ay > by) ; /* set delta_y for non-horiz lines */ 

if (poly_stat — 0) ( /* special treatment for first edge */ 

edgel.x = ax; edgel.y = ay; /* save the endpoints . . */ 
edge2.x = bx; edge2.y = by; 

poly_stat =1; /* .. advance poly_stat flag */ 

return; /* .. and exit */ 

> 

if (delta_y) ( /* reverse upside-down lines */ 

temp = ax; ax = bx; bx = temp; 
temp = ay; ay = by; by = temp; 

> 

raw = (edge *) get_item(sizeof (edge) ) ; /* get a new edge structure */ 
raw->len = by - ay; 

rew->x_base = new->len; /* "rise", as in line-draw routines */ 

naw->x = ax; /* starting value of x */ 

new->x_sign = (bx > ax) ? 1 : -1; /* separate sign.. */ 

raw->x_add = (bx > ax) ? (bx - ax) : (ax - bx) ; /* . . and abs. value */ 
nsw->x_frac = new->x_add » 1; /* initialize fraction to 0.5 */ 
rBw->intensity = poly_intensity; /* store polygon-specific stuff. . . */ 
rew->id = current_id; 

if (old_delta = delta_y) ( /* line is going in the same dir */ 
— (new->len); /* .. so shorten it. */ 

if (delta_y = 0) { /* if it's heading down adjust start */ 
++ay: /* start next line */ 

new->x_frac — « new->x_add; /* and fix up x-pos */ 
while (new->x_frac < 0) { 

new->x -h= new->x_sign; 
new->x_frac •+= new->x base; 

) 



) 



n«w->next = line [ay] ; /* chain new edge into scanline list */ 

linefay] = new; 



* close_|olygon() is called to clean up the polygon, either from area_move() 

* or fron area_end() . We close the polygon by area_draw l ing back to the 

* first joint, then draw the first edge (which was passed over so we could 

* get an initial value for delta v) . 
V 
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static close_polygon() 

area drawfinit.x, init.y) ; /* draw back to start */ 

if (Init.x != edgel.x 1 1 init.y != edgel.y) /* only draw to edgel */ 
area_draw(edgel.x, edgel.y) ; /* if necessary */ 

area_draw(edge2.x, edge2.y); 

) 



* area_end() updates the active list from the line[] array of scan line 



* 



- edges, then re-sorts the list and displays the line. Finally, edges 

* with negative length are removed, and the lines' x-coordinates are updated. 

V 

void area_end() 

edge active; /* dummy node base of active list */ 

register edge *last; /* pointer to end of active list */ 

register SHORT y; /* current scanline number */ 

static edge *update_list() ; /* let compiler know about subfuncs */ 

static void sort_list() , write_scanline() ; 

if (poly_stat = 1) close_polygon() ; 
poly stat « 0; 

last~= iactive; /* pointer to the end of the active list */ 

for (y = 0; y < y_size; ++y) { 

last->next = line[y] ; /* add line[y] to list */ 

line[y] = 0; /* reinitialize line[y] */ 

sort_list(Sactive) ; /* sort the list */ 

write_scanline(active.next, y) ; /* output the scanline */ 
last = update_list(&active) ; /* and update the list */ 

) 

) 

/* 

* sort active list into x-sorted pairs of same-id edges 

V 

static void sort_list(base) 
register edge *base; 

register SHORT id = -1; /* current polygon id, or -1 for none */ 

register SHORT x; /* x-position of leftmost edge encountered */ 

register edge *p; /* scan pointer into list to be sorted */ 

register edge *next; /* pointer to structure after p */ 

register edge *min; /* pointer to leftmost edge so far */ 

while (base->next) ( 

x = 0x7fff ; /* the largest possible value */ 
for (p = min = base; next = p->next; p = next) 

if ((id = -1 || next->id = id) && (next->x <= x)) { 
min = p; 
x = next->x; 

) 

p = min->next; 

if (base != min) ( 

min->next = min->next->next; /* chain across */ 
p->next = base->next; /* chain in forward */ 

base->next = p; /* ■ • and backwards */ 

id = (id = -1) ? p->id : -1; /* toggle id */ 

base = base->next; 
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The vertex count is the number of vertices the polygon has- a 
triangle for example, has three vertices. The intensity is a ' 
number from 0 (black) to 1000 (white) which is the brightness 
of the polygon. If you choose COLOHS, the values 0 to 1000 
will be scaled from color 0 to color 7. After the "polygon 
header" come the vertices. Each vertex is an x,y pair, scaled 
from 0 to 1000. Our coordinate system has y = 0 at the bot- 
tom of the screen, rather than at the top; the data is converted 
to normal scan-line order internally. The list of vertices does 
not need to be closed, with an edge returning to the starting 
point. Rjmember when looking at poly.l and poly.2 that it 
isn t always necessary to have new lines between coordinates 
(or polygons). 

The malnC ) routine reads through data using the C librarv 
function fscanfO; every line should return a value of 2 until 
the last /ertex of the last polygon is read; then EOF will be re- 
turned. (EOF is usually -1 or 0 as defined in the <stdio.n> 
file of your compiler.) Any other value indicates an error in 
the data file. 

The routines used to interface to the area-fill algorithm are 
similar to the ones used internally by the Amiga. To fill an 
area, araa_moveC ) is called to position the cursor, and 

fJu a ~ driw0 t0 connect to each of the remaining vertices 
When all the vertices have been entered in this way, area_ 
end( ) is called; this is the routine that does all the difficult 
work, and actually displays the polygons. 

As a simple example of how these routines work let us 
say we wanted to draw the triangle discussed at the beginnning 
of this section, with vertices at (100,50), (200,100), and 
(150,150) Using the routines in polygon.c, we would say 

set-penCRED); /• let's draw a red triangle V 
area-mo/eClOO, 50); 
area_drawC200, 100); 
area_drawClBO, 180); 
area_end( ); 

and the computer would flash a triangle on the screen Re- 
member that area_moveO, area_drawC), and area_endO 

expect screen coordinates with (0,0) in the upper left-hand cor- 
ner of the screen. 
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The area_draw( ) Routine 

The initial call to area— moveC ) simply sets aside the param- 
eters (x and y) and increments current—id (the reason for 
which we'll discuss in a moment). The initial position is saved 
in init, and the cursor position is saved in pos. 

The area— drawC ) routine is responsible for creating the 
edges and placing them in the appropriate bucket in the scan- 
line array. The area— drawC ) routine takes the passed values, 
and uses that point and the saved pos value to determine the 
line. The new passed value is saved as the current pos. This 
leaves us with the coordinates of the line in (ax,ay) and 
(ox/by). If the line is horizontal, we reject it immediately; hori- 
zontal lines aren't needed to define the area of the polygon, 
since filling the inside of the polygon will define the horizon- 
tal edges for us. 

The tricky part of the routine is determining when edges 
need to be "shortened." We do this by watching whether the 
edges of the polygon are going up or down on the screen; 
when a line going down is followed by a line going up, or 
vice versa, then we're at a local minimum or maximum, and 
we don't need to tamper with the length of the edge. How- 
ever, when two consecutive downwards- or upwards-heading 
edges occur, we shorten the latter edge. To be able to make 
this decision we need to know whether the previous line was 
going up or down when we first start, adding edges; otherwise 
we can't know whether or not to shorten the line. 

The y_ delta value is calculated for the first edge to deter- 
mine the direction of the line to be passed (one for up, zero 
for down), save the line away, and return without doing any- 
thing. Successive edges then have access to the last value of 
y_ delta, and can determine whether they need to be short- 
ened or not. To shorten a line, it's necessary to decrement the 
length counter by 1; for lines going down, it's also necessary 
to actually increment the starting scan line and adjust the 
starting x position accordingly. To do this, adjust x and 
x_ frac; we use the algorithm described below. Lastly, we 
check to see if the line is "upside-down," and if so, we reverse 
the coordinates. (Remember when using these routines: The y 
position is at the top of the screen, so upside-down lines have 
ay > by.) 

Now we begin to create our edge structure. We allocate it 
with get_itemC ), which error-checks the call to callocC )• The 
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Chapter 8 



looking for the edge with the lowest x coordinate. If id is set 
to some positive number, we have to find a matching edge 
(from the polygon with that ID), but we still look for the low- 
est x coordinate with that ID. Once we've found it, if it needs 
to be moved, we unlink it from the list and chain it in at the 
current base position, id is then updated; if we have just fin- 
ished looking for specific edges, we set id to - 1 so the sort 
algorithm will find the leftmost remaining edge, regardless of 
polygon otherwise we set id to p->id to force the algorithm 
to ma tcli the edge we just found. 

Once the sorting loop is done, we check for an id other 
than - 1; this is the only error checking in the area fill 
routines. Under normal circumstances, the id must be - 1 at 
the end of the list, since otherwise we would still be looking 
for a matching polygon edge. If you get an "orphaned edge" 
error, you're probably trying to draw a polygon with zero 
edges, oi something equally baroque. 

When the nested for loops are complete, we move on to 
plot the actual lines themselves. You may have noticed that 
our area_end( ) routine never clears the screen. Instead, at 
this point in the program we clear the current scan line. This 
decreases the amount of flicker that would otherwise be no- 
ticeable if we cleared the screen before redisplaying. However, 
it is possible to see a flickering line sweep down the screen as 
the imagt is redisplayed. One way to eliminate the flicker 
problem entirely is to draw background-color lines between 
the plotted lines. This method, however, is both slower and 
more difficult to implement, so the current method was chosen. 

The last section of code is that required to update the 
edges themselves. We decrement the len counter for each 
edge, which holds the length of the line in scan lines. When 
lea becomes 0, the line is removed from the list by unlinking 
it from the elements before and after it. Rather than maintain- 
ing a pointer to the edge itself as we scan the list, we use a 
pointer tc the edge before the current one. This way, when we 
need to delete an edge, we have a pointer to the previous 
node, and it's easy to "chain" over the node to be deleted. 
After we've removed the edge from the list, we free the mem- 
ory it used; if we put this off until we exited the program (and 
let the compiler handle the freeing for us) we would risk run- 
ning out of memory while the program was executing. 
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Polygon Filling ; 



The last few lines of code in the loop should look famil- 
iar They are a slight modification of the incremental line algo- 
rithm from the last chapter. Notice that we subtract the 
numerator from the fractional variable in this code, rather than 
adding it; since addition and subtraction are mirror-image op- 
erations, we can do this, as long as all the subtractions become 
additions and vice versa. In this case, we perform the subtrac- 
tion so that in the next line we can compare with 0, rather 
than next->x_base; as in machine language, comparing with 
a constant value is faster than comparing with a variable. 

In this incremental routine, it is possible for next->x_add 
to be greater than next->x_base (in essence, an improper 
fraction). Thus, rather than a simple if test, we have to loop 
with while. If the line is very close to horizontal, next- 
>x_base could be very small and next->x_add very large, re- 
quiring us to add next->x_add to next->x_frac many times 
before next->x_frac became greater than or equal to 0. Each 
time through the loop, we add x_sign to x, thus computing 
the intersection of the edge with the next scan line. When we 
exit from the while loop, next->x holds the intersection value 
for the next line. Finally, once we've updated all the edges, we 
assign the last pointer to next, so that we can add the next 
scan line's edges onto the active list in the right place. 

Since it is important to be able to draw accurate poly- 
gons—the human eye is notoriously able to spot the shortcuts 
that can be used in graphics— we recommend that you reread 
the above sections before proceeding. 

In our next graphical endeavor, we'll be using the 
area_moveO, area_drawO, and area_endO routines as 
black boxes. 

Other Fill Routines 

Before we leave the subject of fill routines, however, it seems 
appropriate to at least mention a few of the other fast routines 
that exist to perform scan-line filling. 

The Edge Fill Algorithm. This algorithm is a marvel ot 
simplicity; it is, however, not a fill you'd want to see onscreen. 
The algorithm, in its entirety, is this: For each intersection of 
an edge and a scan line (x,y), perform a logical complement on 
every pixel from (x,y) to the end of the scan line. For each 
pixel, if it was turned on, it is turned off, and vice versa. As 
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Ill "tlllS chapter we will begin discussing the more 
complex and theoretical aspects of computer graphics. The 
idea of portraying three dimensions on the screen is an excit- 
ing one; all that most computer programs ever portray is a flat 
surface, perhaps with a fixed picture of some apparent depth. 
Now we'll introduce you to the basic methods of portraying 
three-dimensional objects on the screen, in any orientation, at 
any distance, with any perspective. 

To do this we'll need to study the subject of matrix trans- 
formations in some detail. The material can be a little difficult, 
but very rewarding once you understand it. We'll begin by de- 
fining the basic terminology, then discuss the various kinds of 
matrices than can be used to move, rotate, grow, shrink, and 
distort the points that make up our image. 

Objects in Three-Dimensional Space 

The first item that needs to be established is how we're going 
to represent all the three-dimensional data that needs to be 
handled. How can we represent a point, a line, a surface? 
How can we describe what needs to be done to these objects 
when we rotate them or move them around in space? 

The obvious way to represent a point in space is as a vec- 
tor with three coordinates— X, y, and z. Thus, using normal 
Cartesian coordinates we could describe the point as x = 1, y 
= 2, z = -3. We'll be using the words point and vector some- 
what interchangeably; a point is just the end of a vector, and a 
vector is just a line from the origin to some particular- point. In 
general, vectors show a direction, and points describe a loca- 
tion, but often both descriptions can be applied to a given 
concept. 

We are not, however, going to describe points (and vec- 
tors) exactly as we did above. For reasons which will shortly 
become clear, we will use a vector of length (or dimension) 4. 
The last coordinate, which we'll call h, will always be equal to 
1 for so-called normalized vectors. Thus, the point above 
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We'll be using the same fundamental concept, but now we'll 
be using 4X4 matrices instead of the the 2 X 2 matrices we 
used previously. 

In our discussion of rotation matrices, a simple matrix was 
used to rotate a two-dimensional vector around the origin by 
theta degrees: 

cos(theta -sin(theta) 
sindheta cos(theta) 

In three dimensions we can rotate points as well. Here, 
however we don't rotate our points around some other point 
(such as the origin). Instead, we rotate them around a line 
(like the x-axis). For example, we could rotate our points 
around the y-axis as shown in Figure 9-3 or around the z-axis 
(Figure 9-4). 



Figure 9-3. Rotation Around the y-Axis 
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Three Dimensions 



Figure 9-4. Rotation Around the *-Axis 
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The matrices that perform the rotation are similar to their 
two-dimensional cousins. The following matrix, for example, 
will rotate a three-dimensional point (x,y,z) around the x-axis 
by alpha degrees: 

10 0 
0 cos(alpha) sin(alpha) 
0 — sin(alpha) cos(alpha) 

Using our four-space vectors and matrices we do almost 
the same thing to rotate vectors. The mysterious h coordinate 
is not needed for simple translations, so we preserve it in the 
transformation (it remains equal to 1). Essentially, we ignore 
the fourth row and fourth column when we're doing rotations 
Thus, to rotate an object around the x-axis by alpha degrees, 
we multiply it by the following matrix: 

(1 0 0 0 \ 

0 cos(alpha) sin(alpha) 0 | 

0 — sin(alpha) cos(alpha) 0 / 

0 0 0 1 / 
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j . anH dzas W e calculate the new values of x, y, and z. The 

S'ri^lS alonfon/y one or two dimensions, we can ieave 
* e STlSStaSi -cem SMS method is speed. Surely 

is, in tact v V^ e f " , th translation matrix can be com- 
SS S^ and only one ^ «gjjg£ 
Hon will be needed to do both the rotation and the translation, 
econd reason relates to professional graphics. In 
ine > e <- u " u a y 4 matrix multiplication is such an 

S^^dTLier to understand and debug, which is an 
advantage in itself. 

Other Transformation Matrices 

Rotation and translation are not the only things that we can 
Rotation ana w als0 sca l e vectors with 

do with ^ ce ^° W ^ wanted to m ove a point to a dis- 

SS SSS-faS^ the 35n as it was to Lgin with, we 

could maltiply it by a scaling matrix: 

(2 0 0 0 
0 2 0 0 
0 0 2 0 
0 0 0 1 

oSy sfaling, which leaves the proportions of x, y. and 

z the same; see Figure 9-5. 



Three Dimensions 



Figure 9-5. Vector Scaling 
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One useful operation in graphics is the shear transform. 
Once we have rotated a "scene" of points, lines, and polygons 
so that our viewpoint is looking down the z-axis, with the x- 
axis horizontal and the y-axis pointing up, we still have one 
problem. The x and y coordinates, while properly aligned, do 
not necessarily have their origin in the right place. Suppose we 
want the display to be centered at (10,5); we need to move all 
the points so that what was (10,5) becomes (0,0); see Figure 9-6. 

Figure 9-6. Shearing 
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Howsver, the one thing such an image lacks if Perspec- 
tive In a parallel transform, edges that are parallel m three di- 
mensions are parallel on the screen (thus the name) For 
Sample, a skeleton cube would have a very simphshc _look to 
TXnce all four of the edges connecting front and back face 
wodd b parallel on the Screen. As those of you who are fa- 
Sr wih the basics of art know, perspective involves a van- 
£h£e print to which all lines parallel to the z-axis appear to 
SreeTsee Figure 9-7). (In fact, some artistic techniques 
ST^uTtipl^^S Wts, but we'll stick to one here.) 

The perspective transform is much more straightforward 
than the shear matrix. To provide perspective, we divide x, y, 
and z by some multiple of z. This will set z to a cons ant 
value, aid will also scale x and y appropriately: The larger the 
value of z (the farther away the point is), the smaller will be 
the resulting x and y, thus creating the vanishing-point effect 
of perspective. Let's use the same cw convention as for the 
shear r£Sx. We want to divide x, y, and z by (z / cw z ) leav- 
ing z eqial to cwz and scaling the x and y to the correct 



values. 



'The actual matrix to create this effect may be something 
of a surprise: 




Th* x y, and z values are passed untouched. Instead, we 
set the i coordinate to z * l/cv> z . So when we multiply a nor- 
mal (x i,z,l) vector by this matrix, we get (x y, z, z/cw z ) as a 
Suit !a her we mentioned that the h coordinate always has 
o be 1 for a normalized vector; having applied a perspective 
transfom, we now have to normalize the vector by dividing 
every Ordinate by the value of the h coordinate. Af e: ' we ve 
normalzed, we have (x / {z/cw z ), y / (z/cw z , cw z> 1) The ft 
coordirate is 1 and the z coordinate is set to the z coariumte 
of the window. The x and y coordinates have been set to the 
appropriate perspective projection. Now we're ready to actu- 
ally display the point on the screen. 



Three Dimensions 



The Screen Transform 

We can't just start plotting x,y coordinates on the screen; the 
points aren't properly scaled.They could range from -1 to 1, 
from 12 to 17, or from -10,000 to 10,000. The x,y points must 
be scaled to fit into the screen. This is done by determining 
what the minimum and maximum x,y bounds are and then 
multiplying each x,y coordinate by some constant vector to 
bring it into screen coordinates. 

Let's assume that we've computed the bounding values 
for our scene and placed them in umax and umin for the x 
coordinate, and vmax and vmin for the y coordinate. For ex- 
ample, a cube with vertices at ( + /-1, wl11 ' 14 
turns out, be bounded by 

umax = 8; 
umin = —8; 
vmax-= 8; 
vmin - -8; 

regardless of how the cube is rotated relative to the display. 
Now, let's further assume that we know the x and y dimen- 
sions of our display screen, and call them x_size and y_size 
(these are, of course, the variables used by machine.c). To 
simplify matters, let's force the screen to be square by ignoring 
the rectangular ends of it (for most display screens, including 
the Amiga and ST, that means we ignore the left- and nght- 
hand sides of the screen, and use a 200 X 200 or 400 X 400 
window in the middle). Let's use the variable size to denote 
the smaller dimension of our screen: 200 on the Amiga and 
Atari color displays, or 400 on the Atari monochrome display. 

Our last transform is going to be from a window of size 
(umax -umin) X (vmax -vmin) centered at (0,0) to a win- 
dow of size size X size centered at (x_size / 8, y_size / 8). 
Remember that up until now we've been using the standard 
mathematical convention of assuming that the y-axis- points 
up. Now we have to flip that; on most computer systems y 
values increase as you go down the screen. Here then is the 
screen transform matrix that we need: 

size/(umax— umin) 0 0 0 

0 — size/(vmax— vmin) 0 0 

0 0 10 

x_size / 2 y_size / 2 0 1 
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From Viewpoint to Transform 

Now we know where we are in space, and where our view- 
plane is. How do we get from this information to a transfor- 
mation matrix? Remember, we want to transform our data so 
that our viewpoint is looking down the z-axis, with vup point- 
ing up the y-axis. Let's introduce two more terms before pro- 
ceeding so as to keep the actual data separated in our minds 
from the displayed picture. World coordinates refer to the raw, 
unconverted data; viewing coordinates are what we have when 
we've (onverted the data into a format suitable to be displayed. 

Figure 9-9. Vectors Define the Display of a Scene 



viewplane 




center of 
projection 



point 



One way to figure out the necessary transformations 
would be to calculate for each of x, y, and z the necessary ro- 
tations needed to bring the vpn all the way around to the z- 
axis (remember, we want the viewplane normal pointing up 
the z-axis at us). However, this would be slow and difficult to 
code or even understand. Instead, we can use the magic of 
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matrices. It turns out that, given three mutually perpendicular 
unit vectors (such vectors, of length 1, are called orthogonal) 
rx ry and rz, the rotation matrix that brings them into align- 
ment with the x-, y-, and z-axes is just the following: 



rx x 


ryx 




rx y 


ryy 


rz y 


rx z 


ryz 


r*z 


0 


0 


0 



Thus, the rx, ry, and rz vectors make up the three first 
columns of the matrix. So, to perform our rotation correctly, 
we merely have to calculate the rx, ry, and rz vectors. These 
vectors are essentially the axes that we're going to rotate 
around into the real x-, y-, and z-axes. 

First however, we have to translate our data so that we re 
rotating about the right point. Rotating about the origin of our 
data isn't going to help us much; instead, we want to rotate 
the data around the center of projection. So, the first thing we 
need to do is multiply the data by a translation matrix (whicn 
we'll call T): 

/I o o o\ 
f 0 1 o o \ 
0 o i o I 

\ —copx -copy -cop z 1 / 

This moves the center of projection to the origin, and all 
the other points move with it. 

At this stage of the game we need to switch from right- 
handed" to "left-handed" coordinates. In the normal right- 
handed system, the z-axis points out of the screen at us, and 
larger z values are actually closer to us. To simplify our picture 
of the image, we switch to left-handed coordinates, m which 
the z-axis points into the screen, and large z values are far 
away. To change coordinate schemes, we can multiply by the 
Tbx matrix (Transform Right to Left): 




As you can see, the matrix switches all the z's from positive to 
negative. 
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rx x ry x rz x o 

rx y ryy rzy 0 

r *z ry z rz z 0 

(-copx*™* (~copx*ry x (-copx*rz x 1 

-copy*rx y ~copy*ry y -copy*rz y 

-copz*rxz) -copz*ry z ) -copz*rz z ) 

If you think back to our discussion of the dot-product 
function, you'll realize that the values on the bottom row are 
actually dot products. The first value is —(cop . rx), the next is 
— (cop . ry), and the last is —(cop . rz). 

Now, we have only to multiply this matrix by Thl and 
we'll be most of the way home. Multiplying our rotation/ 
translation matrix by Tkl is equivalent to negating the third 
column. So, our final matrix (which we'll call A ) looks like 
this: 

rx x ry x -rz x 

rx y ry y -rz y 

rx z ry z -rz z 

-(cop . rx) -(cop . ry) (cop . rz) 

The A matrix leaves the data in a format almost suitable 
for display. Now we have to multiply A by the shear matrix 
SH, which we derived above, so that we can center the win- 
dow to be displayed on the actual screen. 

When we talked about the shear matrix, we assumed the 
existence of a point called cw, the center of the window. 
Using our viewplane model, we know that vrp points to the 
window. (In the just-transformed image, we actually have vrp 
* A pointing to the window.) However, since we may want to 
display some other part of the viewplane in the window (cen- 
tered aiound (10,5), for example, rather than the origin), we 
have to fiddle with vrp a little before we can arrive at the cw 
vector. It would be somewhat silly to display the center of the 
viewplane on the screen if the image were being projected 
somewhere else. 

The plane of the screen is sometimes referred to as the uv 
plane; that is, instead of using x and y coordinates to refer to 
positions on its surface, we use u and v. So, we can "bound" 
the projected data in a rectangular box, with corners at 
(nmln,mln) and (umai,vmax). To find the center of the 
box, we just use Cumin + umai)/2, Cvmin + vmax)/2. Once 
we determine values for the minimum and maximum u and v, 
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we can offset cw by that amount. Remember, the z coordinate 
has been fixed by this time, and doesn't vary as we change 
our position on the window. Using this new value for cw, we 
can apply the shear matrix. 

It's sometimes appropriate to stop at this point. Parallel 
transforms, while not as realistic-looking as perspective trans- 
forms, have several useful properties. They're often easier to 
work with than perspective transforms, and in some cases the 
fact that parallel lines remain parallel can be useful. (The par- 
allel transform matrix is called N pa r ) In general, however, one 
final transform, the perspective transform, is applied. We dis- 
cussed this transform above; it's extremely simple but pro- 
duces a very realistic appearance of perspective foreshortening. 

So, we can now build a complete transform matrix, which 
takes the world-coordinate data and converts it to a rotated, 
sheared perspective representation in left-handed coordinate 
space. The A matrix can be created "in place" from the trans- 
late, rotate, and transform right-to-left matrices. We then mul- 
tiply A by the SH (shear) matrix, and in turn by the perspective 
matrix, P. The result is called Mr per , the final transform matrix: 

Wper - T • K • Thi. * SH * P 

Now we only need to multiply N per by some suitable 
screen-transformation matrix, as discussed above, and we're 
ready to start plotting points. 
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We've progressed from a simple scene to 

a set of data ready for display. But how can it be displayed? 
The obvious method is simply to display the newly trans- 
formed lines, but more complex display techniques, such as 
hidden line and hidden surface removal, require more compli- 
cated programming. 

A Sample Object 

In Chapter 9 we made reference to a cube as an example. In 
this chapter, we'll discuss this cube exclusively, since it serves 
our purpose for simple graphics display. We'll define the cube 
as an array of type vector; a vector is defined as an array of 
four floats, x, y, z, and h. A transformation matrix (type 
transform) will be defined as a two-dimensional 4X4 array 
of floats. Here are the C definitions: 

typedef FLOAT vector[4]; 
typedef FLOAT transformMM; 

We can now define the cube as a simple array of vectors, 
which will be the vertices of the cube: 

vector cxibe[ ] = { 

-1, -1, -1, 1, 

-1, 1, -1, 1, 

1, 1, "I, 1» 
1, -1, -1, 1, 

-1, -1, 1, 1. 
-1, 1, 1, 1, 

1, 1, 1» 1, 

1, -1, 1, 1. 

}; 

Notice that the n coordinate is always 1. 

In our header module base.h. (Program 10-1), we not only 
declare the typedefs for vectors and transforms, but also '"de- 
fine a few constants to clarify the use of individual floats 
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Displaying the Data 

With vhat we know now, it's fairly easy to create the eight 
transformed points of the cube. The actual displaying of the 
data is done by the display. c module, Program 10-3. The 
displey-updateO routine handles the displaying; it gets the 
key transform matrix (N per ) from the perspect.c module 
(Program 10-4), and multiplies it by the screen transform to 
get a single transform to apply to all the points. Each of the 
eight points is multiplied by this matrix and normalized, leav- 
ing the result in another array of vectors (called points in our 
code) A global variable, fill, is used to determine how to dis- 
play the data; we can display all the lines, display only the 
visible lines, or display the visible surfaces of the cube. 

Tlie display.c module includes one rather ugly piece of 
code. When display.c is compiled under the Lattice compiler, 
a smal check is inserted into the program. The bottom right 
value of the final matrix is always exactly equal to 2.0, as a re- 
sult oi a variety of matching computations. However, the Lat- 
tice ccmpiler has one extremely subtle bug in the floating- 
point package. When this bug manifests itself, a likely result is 
that tikis value will no longer equal 2.0. At this point, the pro- 
gram Jxits, since it cannot display the cube from the requested 

position. 1.1. 

Displaying all the lines is simplicity itself; we clear the 
screer, set the pen color to WHITE, and draw lines between 
the appropriate vertices to create the 12 edges of the cube. The 
result is a "wire mesh" picture; it's as if the cube were made 
from toothpicks. The draw_outline_cubeO routine is re- 
sponsible for drawing the cube outline; it draws nine edges 
with a continuous draw, then the remaining three with sepa- 
rate move/draw commands. Notice that the FLOAT values of 
the vtctor coordinates are cast to SHORT before being passed 
to themoveC) and drawO routines. Some improvement in 
accuracy (and decrease in speed) could be made by adding 0.5 
to each value before truncating it to SHORT, but the improve- 
ment didn't seem worth the extra overhead. 

\ery few of the shapes we see in the real world are made 
of tocthpicks. What is needed is some form of hidden line 
elimination. When you're looking at one face of the cube, for 
example, the face that lies on the far side shouldn't be dis- 
played. In the general case, this is a difficult proposition, but 
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for a cube it's possible to work out a simple algorithm to re- 
move hidden lines. 

The easiest way to remove hidden lines is to consider 
which faces of the cube are visible, and plot the edges which 
make up the boundary of the cube. It may at first seem diffi- 
cult to determine which faces of the cube are visible; after all, 
when you're looking at the cube straight on, only one face is 
visible, but if you're looking at it from an angle, then as many 
as three faces can be seen. The solution turns out to be quite 
straightforward. We know that each face of the cube has x, y, z 
equal to + so, if your x coordinate is greater than 1, the 
face with x = 1 must be visible. Likewise, if your x is less 
than -1, the x = -1 face is visible. When x is between -1 
and 1, neither face can be seen. Similar computations are used 
to display the faces with y = +/— 1 and z = +/ — 1. 

In general, however, figuring out which lines are hidden 
is a difficult process. Lines may be partially hidden by other 
lines; lines may be visible through "holes" in other polygons. 
Hidden lines in general require a lot of computation and anal- 
ysis which we won't be going into here. However, in 
display.c we use this simple algorithm to erase hidden edges. 

The problem of hidden surfaces is also a nontrivial one, 
but one that we will be addressing in chapters to come. For 
the moment, we'll use the same algorithm as above to deter- 
mine which faces of the cube are visible, and simply plot them 
with our area—moveC ), area_drawC ), and area_endC ) 
functions from the last program. We'll arbitrarily assign the 
colors white and yellow, red and purple, and blue and green 
to opposite sides of the cube. 

In display.c, the draw_filled_cubeC ) routine is used to 
determine which faces are visible. For hidden-line display, the 
display is cleared, and each call to add_faceO results in a paral- 
lelogram being drawn on the screen with moveC ) and drawC > 
For hidden-surface display, we pass draw_filled_cubeC ) a 
parameter of 1, and it uses the area_moveO, area_drawO, 
and area— endC ) routines instead. 

The parameters to add_f aceC ) are the four vertices that 
make up the parallelogram that we want to display, with an 
additional color parameter. The color parameter is ignored by 
the hidden-line code (which draws everything in WHITE), but 
the hidden-surface code uses the color parameter to choose 
what color to draw the polygon surfaces in. (For a discussion 
of the area-fill routines, refer to Chapter 8.) 
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Other Modules 

Two ot\er modules have been provided, amigapoly.c and 
stpoly.s (Programs 10-7 and 10-8), both of which have fast 
built-in polygon-filling routines. These two modules serve as 
replacenents for the standard poly.c module (Program 10-6) 
on the \miga and the ST. The Amiga uses a coprocessor chip, 
the blit'er, to generate filled areas, which results m blindmgly 
fast area fills. The ST, although it doesn't have a blitter has 
fast, dedicated machine language code which handles the till 

routines. . 

To use the amigapoly.c routine, it s necessary to make a 
new cow of the machine.c module, with the exlt_grapHics( ) 
function removed. The amigapoly.c module includes its own 
version of the exit_graphicsC ) call, which handles de-allocating 
the exta memory space the Amiga needs to do the filling, and 
the exta screen that we use to double-buffer the display. The 
stpoly c module can be compiled and linked, in lieu of poly.c, 
without altering machine.c. 

Progrim 10-1. base.h 

/* 

* type definitions for cube. 

tjpedef FLOAT vector [4] ; /* vector in homogenous 4-space */ 

typedef FLOAT transform[4] [4] ; /* transformation matrix */ 

#def ire X 0 /* defines for the vector type */ 

#def ine Y 1 
♦define Z 2 
♦define H 3 

extern -rector cop, vrp, vpn, vup; 

extern 1LOAT Umax, vmax, umin, vmin; 

extern 1LOAT persp; 

extern iHORT fill; 

extern transform screenjt; 

extern transform *get_perspective_transform{) ; 
extern OOAT magnitude () , dot_product() ; 
extern tor *get_item() ; 

Progrim 10-2. main.c 



/ * This module contains the main program loop as well as most of 
* the :ey top-level functions. 

V 

♦include <stdio.h> 
♦include "machine. h" 
♦induce "base.h" 

vector cop, /* center of projection */ 
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vrp, 
vpn, 
vup; 

FLOAT umax = 2, 
transform screent < 
SHORT fill = i; 
FLOAT persp; 



/* viewplane reference point */ 
/* viewplane normal */ 
/* viewplane up */ 

vmax = 2, umin = -2, vmin - -2; /* window bounds */ 
= { 1,0,0,0, 0,1,0,0, 0,0,1,0, 0,0,0,1 ); 
/* fill mode (wire mode) */ 
/* location of viewplane relative to cop */ 



main 



0 



FLOAT size; 
char input[256]; 



/* size of window */ 
/* input buffer */ 



init_graphics( COLORS) ; 

size - (FLOAT) ( (x size > y_size) ? y_size : x_size) ; 

fill =1- ~ /* wiremode fill */ 

persp =0.5; /* perspective (positive of vrp) */ 

/* create screenjt matrix (projection to screen) */ 
screen_t[0] [0] = size / (umax-umin) ; /* scale ... */ 
screen t[l][l] = -size / (vmax-vmin) ; 

screen_t[3][0] = ( (FLOAT) x_size) / 2; /* . . and translate */ 
screen_t[3][l] = ( (FLOAT) y_size) / 2; 



vup[Y] = 1; 
cop[Z] = 10; 

vrp[Z] = cop[Z] * persp; 
vpn[Z] = ZERO - vrp[Z]; 
vpn[H] = vrp[H] = cop[H] 

display update ( ) ; 



/* vup points to +y */ 
/* cop points to +z */ 
/* vrp is between cop and the origin */ 
/* vpn points towards us */ 
vup[H] = 1; 

/* start with something on screen */ 



for (;;) 



/* input loop */ 



get_input( input) ; 
if (input[0] >= 'A' && input[0] 
input[0] +- ('a' - 'A"); 
parse(input[0], &input[l]); 



/* force lowercase */ 



* The parse routine is passed a command (as a char) and its arguments 

* (a string) . A switch() statement selects the code to syntax-checK 

* the command and call the appropriate support routine. 
* 

* Note that Atari Alcyon's compiler will always fill in 

* the variables, even if there aren't any values to put in them, so 

* the syntax checking fails and zeros are returned for the absent variables. 

V 

parse(c, s) 
register char c, *s; 

/* note: these variables can't be register; we need their addresses */ 
float x, y, z, theta, n; /* command line input variables */ 

switch (c) ( 

CclS€? ' 3l ' " 

if (sscanf (s, »%f%f%f", &x, &y, &z) != 3) 

printf ("syntax: a xpos ypos zpos\n") ; 

else cop_locate( (FLOAT) X, (FLOAT) y, (FLOAT) z) ; 
break; 
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update_viewpoint (scale) ; 

> 

/* 

* update viewpoint () applies the given transform to OOP, VRP, 

* VPN, and VUP, then updates the display via display_update ( ) . 

* If we tr}' to rotate or scale into the cube, it's rejected. 
*/ 

int uptete_-viewpoint(m) 

transform mj 

{ 

vector new_cop; 

poiit transformfcop, newjxp, m) ; 

if new cop[X] <= 1 new_cop[X] >= -1 && new_cop[Y] <= 1 

&& new_cop[Y] >= -1 new_cop[Z] <= 1 && new_cop[Z] >= -1) ( 
printf ("can't move within cube\n") ; 
return 1? 

} 

els-e { , „ , 

cop[X] = new_cop[X]; cop[Y] = new_cop[Y] ; cop[Z] * new_cop[Z]; 

point_transform(vrp, vrp, m) ; 

point_transform(vpn, vpn, m) ; 

point_transforra(vup, vup, m) ; 

display_update() ; 

return 0; 

) 



Program 10-3. display.c 

/* 

* This pactage handles the cube's high-level graphics interactions 

* with the screen. 
*/ 

♦ include "mchine.h" 
♦include "tase.h" 

static vector cube[8] = { /* define our cube */ 



"lr 


-1, 


-1, 


1, 


-1, 


1, 


-1, 


1, 


lr 


1, 


-1, 


1, 


1, 


-1, 


-1, 


1, 


-1, 


-1, 


1, 


1, 


-1. 


1, 


1, 


1, 


1, 


1, 


1, 


1, 


1. 


"I, 


1, 


1 



J-f —I - 

); 

static vector points[8] ; 
/* 

* display update () calls perspective_transform() to get the 

* key transform matrix, multiplies it with the device driver 

* matrix screen_t, applies the transform to the cube of the cube, 

* then calls redraw_display() to invoke the proper drawing routine. 
V 

display_upcate ( ) 

( 

transform m; 
recister SHORT i; 
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uispiaymg inree uinutrugpjis 



#if LATTICE 

FLOAT delta; 

#endif 



nBtrixjnultiply(get_jjerspective_transform() , 



i_t, m); 



#if IOTCE 

/* check the matrix's internal consistency: we know mathematically 

that the value of m[3] [3] must be 1 / (1 - persp) . */ 
delta = 1 / (1 - persp) ; 
delta = (delta - m[3][3]) / delta; 
if (delta > .01 | | delta < -.01) 

punt ("Lattice float bug has manifested. . data corrupted") ; 

#endif 

for (i = 0; i < 8; i++) ( 

point_transform(cube[i], points[i], m) ; 
normalize (points [i]) ; 



> 

redraw_display() ; 



* redraw_display() calls either draw_filled_cube() or draw_outline_cube ( ) 

* to actually render the image. 
V 

redraw_display ( ) 



{ 



switch (fill) { 

case 1: draw_outline_cube ( ) ; break; 
case 2: draw_filled_cube(0) ; break; 
case 3: draw_filled_cube(l) ; break; 

) 



/* 

* draw_outline_cube() draws the edges of the cube. 
V 

draw_outline_cube ( ) 

( 



clear () ; 

set_pen( (SHORT) WHITE); 

move ( (SHORT) points[0][X] 

draw( (SHORT) points[l] [X] 

draw( (SHORT) points[2][X] 

draw( (SHORT) points[3][X] 

draw( (SHORT) points[0][X] 

draw( (SHORT) points[4][X] 

draw ((SHORT) points [5] [X] 

draw( (SHORT) points[6][X] 

draw( (SHORT) points[7][X] 

draw( (SHORT) points[4] [X] 

move ( (SHORT) points [ 1 ] [X] 

draw( (SHORT) points[5][X] 

move ( (SHORT) points [2 ] [X] 

draw( (SHORT) points[6] [X] 

move ( (SHORT) points [ 3 ] [X] 

draw( (SHORT) points[7J[X] 



(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 



points[0][Y]) 
points[l][Y]) 
points [2 ][Y]) 
points[3][Y]) 
points[0][Y]) 
points[4][Y]) 
points[5][Y]) 
points[6][Y]) 
points[7][Y]) 
points [4] [Y]) 
points[l][Y]) 
points[5][Y]) 
points[2][Y]) 
points[6][Y]) 
points[3][Y]) 
points[7][Y]) 



* draw_f illed_cube ( ) checks to see which faces are visible 

* by noting the position of the OOP. If we are more than 1 away 
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Chapter 12 



4. Calculate the intersections and plot whatever is visible. 

Nov that we've eliminated some lines by drawing them, 
and sorre lines by throwing them away, we still have some 
lines whose intersections with the window must be calculated. 
Some lines may have one endpoint in the window and the other 
outside of it; then the line must be clipped and only the visi- 
ble portion of it drawn. Some lines, even though they pass the 
test abore, aren't displayed at all, like line Q in Figure 12-1. 

Figure 12-1. Lines to be Displayed 




The obvious method to calculate the intersections of the 
remaining lines with the edges of the windows is to calculate 
the inteisections of the line with the lines that make up the 
borders of the window. Some of these intersections may lie 
outside :he window itself; consider the intersections of line Q 
with the lines that make up the window border (see Figure 12- 
2). 

When an intersection of the line and a window borderline lies 
within tie window itself, we use that as the new endpoint of 
the line. 

However, this process is difficult and time-consuming. 
Calculating the intersections with the various window border- 
lines is difficult, since we have to solve parallel equations to 
calculate the slope and take special care of vertical lines. This 
is a difficult process, and, as it turns out, an unnecessarily dif- 
ficult one. The Cohen-Sutherland algorithm provides a simpler 
method of determining intersection. 



TQ7 



Clipping 



Figure 12-2. Line Intersecting Window 



1 


intersection 




^ with right edge 




intersection 




\. with top edge 







Essentially, we clip the line successively against each border- 
line, as necessary, using the code computed in step 1 to figure 
out which sides we need to clip against. 

For example, we can begin with the left side of the win- 
dow. For the moment, let's consider endpoint 1 only. If bit 0 
of the code is set, we know the endpoint is outside the win- 
dow. So, we have to figure out where it intersects the left edge 
of the window. Let's assume for the moment that our line runs 
from (xl,yl) to (x2,y2), and that the left edge of the window is 
at x = 0. Then, we have to calculate the y-intercept of our line 
at x = 0. Remember, the formula for a line can be expressed 
in two ways: 

y = yl + slope * (x — xl) 
x - xl + 1/slope * (y - yl) 

where slope = rise/run = (y2 - yl)/{x2 - xl). 

To calculate the intersect of the line with x = ff, then, we 
have to calculate a new value for yl. To do this, we plug in 0 
for x in the equation for y above. The result is the new value 
of yl, and the new value for xl is 0. The equation we use to 
arrive at the new value for yl is thus 

yl + (y2 - yl)/(x2 - xl) * (0 - xl) 

We now have a new value for (xl,yl). The new line seg- 
ment from (xl,yl) to {x2,y2) is not guaranteed to be visible; all 
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w[Y] - v[Y] f 
w[Z] = v[Z]; 
w[H] = v[H] ; 

} 

scale.ccp/jectortv, w, .) /* copy vector v to w, scaling by s V 
register vector v,w; 
register FMAT s; 

w[X] = v[X] * s; 
w[Y; = v[Y] * s; 
w[Z| ■= v[Z] * s; 
w[H] = v[H] ; 

} 

dividejwctnrCv, a) /* scale vector v down by a */ 

register vector v; 
register FIQAT a; 

1 if (a = 0) punt(»divide_vector: attempt to divide by zero") ; 

elee { 

v[X] /= a; 
v[Y] /= a; 
v[Z] /= a; 
v[H] = If 

) 

} 

subtractjwctortv, w, result) /* set result to v - w V 
register victor v, w, result; 

result[X] = v[X] - w[X] ; 
result[Y] = v[Y] - w[Y] ! 
result [Z] = v[Z] - w[Z]; 
result [H] - 1; 

) 

/* Note: tais routine is typically where the Lattice float bug shows up V 
FLOAT LgritaJe(v) /* return magnitude of vector v */ 

register vector v; 

{ return (FLOAT) sgrt(v[X]*v[X] + v[Y]*v[Y] + v[Z]*v[Z]) ; 

) 

FLOAT dot j.roduct(v, w) /* return dot product of v and w */ 
register sector v, w; 

nta v[X]*w[X] + v[Y]*w[Y] + v[Zj*w[Z]; 

) 

cross_proAict(v, w, result) /* set result to cross product of v and w */ 
register Tector v, w, result; 

rtsult[X] =v[Y]*w[Z] -v[Z]*w[Y]; 
result[Y] = v[Z]*w[X] -v[X]*w[Z]; 
result [Z] = v[X]*w[Y] - v[Y]*w[X] <" 
result [H] = 1; 

) 
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. k MATRIX OPERATIONS — ~~*/ 

7 * the point transformO routine takes v and m (a vector «nd. 

* transformation matrix) and sets result to the result of their 

* SSuct. Note that temp is used internally so we can have v - result. 

* To improve speed, no looping is done. 
*/ 

point_transform(v, result, m) 
register vector v; 
vector result; 
register transform m; 

( 

J2^^vrXl*mrO][X] +vm*m[l][X] + V[Z]*m[2] [X] + v[H]*m[3] [X] 

2255 - vmZ Y + v Y *m 1 Y + v[Z]*m[2] [Y] + V[H]*m[3] [Y] 

v X \Z 0 Z t v Y )Z 1 Z + v Z *m mm + v[H]*m[3][Z] 

result[X] = temp[X]; 
result[Y] = temp[Y]; 
result [Z] = temp[Z]; 
result [H] = terap[H] ; 

) 

7 * rotate transformO is called from main.c to provides rotation 

* SSix-for rotate_cop() . Tne passed 

* cos and sin values are appropriately inserted according to the 

* value of d (dimension) , which can be X, Y, or Z. 
*/ 

rotate_transform(d, theta, m) 
register SHORT d; 
register FLOAT theta; 
register transform m; 

( register SHORT i, j; 

for (i = 3; i >= 0; i-) for (j = 3; j >= 0; j-) m[i][j] = 0; 
S][0] - klim - -PIP! = 0.0 + cos(theta); /* Megamax bug!! V 
m[d][d] = m[3)[3] =1; 
switch (d) ( /* Megamax bug */ 

switch (dM / ^ _ = sin(theta ; break; 

case Y: a 0 2 = ZERO - (m[2][0] = sin(theta ; break; 
case Z: m[l][0] = ZERO - <m[0][l] - sin(theta)); break; 

) 

} 

'** matrixmultiplyO multiplies a and b, leaving the result in "result". 
*/ 

matrix_multiply(a, b, result) 
register transform a, b, result; 

{ 

register SHORT i, j; - 
for ti = 0; i <= 3; i++) for 0 = 0; j <= 3; 

result[i][j] = a[i][0]*b[0][j) + a[i][l]*b[l][ 3 ] + 
a[i][2]*b[2][j] + a[i][3]*b[3][j]; 

) 
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We've gotten this far without worrying about 

what to do when lines go off the screen. In polygon.c, we re- 
jected lines that went off the screen initially. In zbuf, we al- 
ways made sure that the screen was big enough to hold the 
entire picture. However, it's not always desirable to scale the 
image down until it fits on the screen. In cube.c we observed 
that if you got close enough to the cube, the lines drawn on 
the screen would extend off it; on the Amiga this sort of be- 
havior usually results in a crash. 

How, then, can we avoid drawing lines off the screen? 
This, and other related topics, is an important question in 
computer graphics. Keeping the lines on the screen — clipping 
them so that they fit — is crucial for all drawing applications. 
Some computers take care of clipping for you; the Amiga will 
do this if you use windows rather than screens for the display. 
However, even when the computer can do the operation, it's 
usually better to do it ourselves, since it gives a greater degree 
of control. It's also necessary, sometimes, to clip the image in 
ways in which the computer can't operate. 

Two-Dimensional Clipping 

The simplest form of clipping is clipping points so that they 
fall on the screen. The problem is a simple one, and is easily 
solved. Let's say we have a point (x,y) that we want to plot on 
the screen, and the size of the screen is (x_size, y_size). To 
determine if the point is on the screen, all we have to do is 
m?ke sure that all the following tests are true: 

x < x_size 
x >= 0 
y < y_size 
y >= 0 

If so, the point is on the screen, and we can plot it. Let's write 
a "front end" to the plotO routine in machine. c, which 
checks these conditions for us: 
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^intensity - poly_intensity; /* store polygon-specific ■ " * 

new-i-id = current_id; 

„ i s aoiwj in the same dir */ 

if (old_delta - deltas) ( /* it. _ */ 

— (new->len) ; / " heading down adjust start */ 

if (delta_y — 0) { /* If It s nea y gtart ^ ^ t/ 

^xfrac-new-x.add; /* and fix up x-pcs V 
while (new->x_frac < 0) { 

new->x 4= new->x_sign; 

new->x_frac 4= new->x_base; 

} 

) 

^ i i^ravl • /* new edge into scanline list */ 

new->next = lme[ay] , / 
line[ay] = new; 

} 

^ clos^lygon(> is ----- - ffS^S^^ 

I r^o^-^^Ti^eg^ was passed over so we c^d 
* get »n initial value for deltajr) . 

static void close_polygon() 

, . , /* draw back to start */ 

area draw(init.x, rnit.y) ; only draw to edgel V 

if (Init.x != edge^x I mrt.y I- edgel.y) f i / nBCe8sary */ 

area_draw(edgel.x, edgel. y) , / 
area_draw(edge2.x, edge2.y); 

) 

'\ are, end(> updates the active ^^^T^T^ rf 

V 

void area_end() 

*/ 



/* dummy node base of active list * 
edge active; ' pointer to end of active list * 

register edge *last; t serine number V 

register SHOOT y; . ' let ^iier know about subfuncs */ 

if (poly_stat - 1) close_polygon() ; 

^-ftaciive; /* to the end of the active list */ • 

for (y = 0; y < X-«*»J **> . ( /* add line[y] to list V 

last->next = line[y] , / ^^^^^ line[y] */ 

line[y] = 0; ' rt the list */ 

sort_list(&active) / ^ s^ine V 

OT ite_scanlim active^t, y) , / ^ list */ 
last = update_list(&active) , / 



) 



* sort active list into x-sorted pairs of same-id edges 
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static void sort_list(base) 
register edge *base; 

register SHORT id = 
register SHORT x; 
register edge *p; 
register edge *next; 
register edge *min; 



-1; /* current polygon id, or -1 for none */ 

/* x-position of leftmost edge encountered */ 

/* scan pointer into list to be sorted */ 

/* pointer to structure after p */ 

/* pointer to leftmost edge so far */ 



while (base->next) { 

x = 0x7fff ; /* the largest possible value */ 
for (p = min = base; next = p->next; p = next) 

if ( (id — -1 || next->id — id) && (next->x <= x) ) 
min = p; 
x = next->x; 



p = min->next; 

if (base != min) ( 

min->next = mxn->next->next; 

p->next = base->next; 

base->next = p; 

id = (id = -1) ? p->id : -1; 
base = base->next; 

if (id != -1) punt("sort_list: orphaned edge") ; 



/* chain across */ 
/* chain in forward */ 
/* .. and backwards */ 



/* toggle id 



V 



/* 

* display scan line 
*/ 

static void write_scanline(p, 
register edge *p; 
register SHORT y; 

( 



y) 



set_pen( (SHORT) HACK) ; 
move ( (SHORT) 0, y); 
draw(x_size - 1, y) ; 
while (p) { 

set_pen(p->intensity) ; 
move(p->x, y) ; 
p = p->next; 
draw(p->x, y) ; 
p = p->next; 

) 



/* black out line */ 



/* draw in polygon scanlines */ 
/* set new intensity 

/* move to start of scanline */ 

/* . . and draw to end of scanline */ 

/* advance edge pointer */ 



/* 

* update the current scan line 
V 

static edge *update_list (p) 
register edge *p; 

( 

register edge *next; 
while (next = p->next) 

if (— (next->len) < 0) ( 

p->next = next->next; 
free (next) ; 



) 

else ( 



next->x frac 



next->x add; 



245 



— -• 



Chapter 11 



_«£..< _IW fipf ft'" f'M'^r^ > 




Program 11-10. 
rings 



4 1.0 
-1 -5 1 
1-5 1 
15 1 
-15 1 

4 1.0 
-1 -5 -1 
1 -5 -1 
15-1 
-1 5 -1 

4 1.0 
-1 -5 -1 
-1 5 -1 
-15 1 
-1 -5 1 

4 1.0 

1 -5 -1 
15-1 

15 1 

1- 5 1 

4 0.8 
-2 -4 2 

2- 4 2 

2 4 2 
-2 4 2 

4 0.8 
-2 -4 -2 
2 -4 -2 
2 4-2 
-2 4 -2 

4 0.8 
-2 -4 -2 
-2 4 -2 
-2 4 2 
-2 -4 2 

4 0.8 
2 -4 -2 
2 4-2 

2 4 2 

2- 4 2 

4 0.6 
-3 -3 3 

3- 3 3 

3 3 3 
-3 3 3 

4 0.6 

-3 -3 -3 
3 -3 -3 



3 3-3 
-3 3 -3 



Program 11-11. 
fl5 



4 0.6 


3 


. 8 




-3 -3 -3 


0 


n 


n 
u 


-3 3 -3 


7 


-L 


Z 


-3 3 3 


7 


—1 




-3 -3 3 










3 


Q 
. O 




4 0.6 


0 


U 


u 


3 -3 -3 


7 


—1 


-z 


3 3-3 


7 


3 


- z 


3 3 3 








3-3 3 


3 


. 8 






0 


0 


u 


4 0.4 


7 


—1 


2 


-4 -2 4 


7 


3 


2 


4-2 4 








4 2 4 


3 


.8 




-4 2 4 


0 


0 


0 




7 


3 


-2 


4 0.4 


7 


4 


-1 


-4 -2 -4 








4 -2 -4 


3 


.8 




4 2-4 


0 


0 


0 


-4 2 -4 


7 


3 


2 




7 


4 


1 


4 0.4 








-4 -2 -4 


3 


.8 




-4 2 -4 


0 


0 


0 


-4 2 4 


7 


4 


-1 


-4 -2 4 


7 


4 


1 


4 0.4 


4 


.8 




4 -2 -4 


7 


—1 


-2 


4 2-4 


7 


3 


— 2 


4 2 4 


14 


3 


-2 


4-2 4 


14 


-1 


-2 


4 0.2 


4 


. 8 




-5 -1 5 


7 


—1 


2 


5-15 


7 


3 


2 


5 15 


14 


3 


2 


-5 15 


14 


-1 


2 


4 0.2 


4 


.8 




-5 -1 -5 


7 


3 


-2 


5 -1 -5 


7 


4 


-1 


5 1-5 


11 




_i 

X 


-5 1 -5 


11 


3 


-2 


4 0.2 


4 


.8 




-5 -1 -5 


7 


3 


2 


-5 1 -5 


7 


4 


1 


-5 15 


11 


4 


1 


-5 -1 5 


11 


3 


2 


4 0.2 


4 


.8 




5 -1 -5 


7 


4 


1 


5 1-5 


11 


4 


1 


5 15 


11 


4 


-1 


5-15 


7 


4 


-1 




3 


.8 




11 


3 


-2 


11 


4 


-1 


16 


3 


0 


3 


.8 




11 


3 


2 


11 


4 


1 


16 


3 


0 


3 


.8 




11 


4 


1 


11 


4 


-1 


16 


3 


0 


19 


.8 




16 


3 


0 


11 


3 


-2 


12 


3 


-2 


12 


3 


-5 


17 


3 


-7 


25 


3 


-19 


30 


3 


-18 


29 


3 


-8 


29 


3 


-5 


39 


3 


—5 


39 


3 


5 


29 


3 


5 


29 


3 


8 


30 


3 


18 


25 


3 


19 


17 


3 


7 


12 


3 


5 
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2 


11 
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2 


19 


.8 
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12 
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17 
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2.8 


-2 



A 

H 
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12 
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A*saMove(rp2, (long) x, (long) y) ; 

} 

7 * 

* area_diaw() to another vertex of the same polygon. 

V 

area_draw:x, y) 
SHORT x, j{ 

' AieaDraw(rp2, (long) x, (long) y) ; 

) 

7 * area «d() performs the AreaEnd() call to close off the last polygon, 

* thendsplays the previously inactive, just-created picture by using 

* the Intuition ScreenToFront() call to bring it onto the display. 
V 

area_end( 

' register struct Screen *s; 

register struct RastPort *r; 

SjtAPen(rp2, (long) last_intensity) ; 
Area£nd(rp2); 

StAPen(rp2, (long) intensity); 
if (screen2) { 

s = screen2; screen2 = screen; screen = s; 

r » rp2; rp2 - rp; rp - r; 

ScreenToFront(s) ; 

) 

CDDB ■ 1? 

) 

7 * our undated exit_graphics() function frees the extra memory needed 

* for AieaFill (with FreeRaster) and closes the extra screen. 
V 

void exit_graphics(s) 
char *s; - 

( 

register char c; 

HBenchToFrontO ; 

If (s) printf ("%s\n", s) ; 

printf ("Hit RETURN to exit from program (Amiga-M to see picture) — ) 
ihile ((c = getcharO) != '\n' £.& c != EOF) ; 
f (rp-> l ImpRas) 

FreeRaster(rp->TmpRas->RasPtr, (long) x_size, (long) y_size) ; 
if (screen2) closeScreen(screen2) ; 
Lf (screen) CLoseScreen( screen) ; 
Lf (GfxBase) clcselibrary(GfxBase) ; 
if (IntuitionBase) caoseLibrary(IntuitionBase) ; 
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Program 10-8. stpoly.c 



/* 

* The stpoly.c module handles the Atari's area-fill routines with the 

* built-in v_fillarea() routine. 
V 

finclude <osbind.h> 
# include <stdio.h> 
# include "machine. h" 

/* public variables */ 

extern SHORT real_intensity, handle, physscr; 
extern long graphscr; 



/* array of vertices for polygon */ 

/* pointer into the array */ 

/* intensity when area_move() called */ 

/* pointer to new memory */ 

/* the other graphics screen */ 



/* local variables */ 
static SHORT pxyarray[256] ; 
static SHDRT pxyptr = 0; 
static SHORT last_intensity = -1; 
static char *map = NULL; 
static long newgraph; 

/* 

* When area_move() is called for the first time, last_intensity is -1. We 

* take advantage of this fact to initialize the fill style and create a 

* block of memory we can use as an alternate screen. If a polygon is 

* currently open, we close it; otherwise we assume that we're beginning 

* to draw on the screen and clear it. 
V 

area_move(x, y) 
SHORT x,y; 
{ 

register long t; 

if (last_intensity = -1) { 

vsf_color (handle, 1) ; 
vsf_interior (handle, 2) ; 
vsf_perimeter (handle, 0) ; 

if (map = malloc(65535) ) /* try to get another screen */ 

newgraph = ((unsigned long) map & " (0x7fffL) ) + 32768L; 
else ( /* not enough memory to doublebuffer */ 

newgraph = graphscr; 



/* initialize fill style */ 



) 
) 

if (pxyptr = 0) ( 

t = graphscr; 
graphscr = newgraph; 
clear () ; 
graphscr = t; 

} 

else l_area_end() ; 
last_intensity = real_intensity; 
area_draw(x, y) ; 



/* clear and initialize */ 



/* close any open polygons */ 



) 
/* 

* area_draw() just adds x and y to the pxyarray table. 
V 

area_draw(x, y) 
SHORT x, y; 



pxyarray [ pxyptr++ ] 



x; 



249 



Chapter 11 



*/ 

point_tr»nsfann(v, result, m) 
register vector v; 
vector rssult; 
register transform m; 

' sector temp; 

tenprX] = v[X]*m[0][X] + v[Y]*m[l][X] + v[Z]*m[2] [X] + v[H]*m[3] [X] ; 

cenp Y = v[X]*m[0][Y] + v[Y]*m[l] [V] + v[Z]*m[2] [Y] + v[H)*m[3] [Y] ; 

temprzi = v[X]*m[0][Z] + v[Y]«m[X][Z] + v[Z]*m[2][Z] + v[H]*m[3] [Z] ; 

temp[H] = v[X]*m[0][H] + v[Y]*m[l][H] + v[Z]*m[2][H] + v[H]*m[3] [H] ; 
result[X] = temp[X] ; 
result[Y] = temp[Y] ; 
result [Z] ■ temp[Z]; 
result [H] = temp[H] ; 



/* 

* rota1e_transform() is called from main.c to provide a rotation 

* matrjx for rotate_cop() . The passed matrix is zeroed, then 

* cos and sin values are appropriately inserted according to the 

* valu< of d (dimension) , which can be X, Y, or Z. 
*/ 

rotate_lransform(d, theta, m) 
register SHORT d; 
register FLOAT theta; 
register transform m; 

{ 

register SHORT 1, 3; 

for (i = 3; i >= 0; i— ) for (j = 3; j >= 0; j— ) m[i][j] = 0; 
m[0][0] = m[l][l] = m[2][2] = 0.0 + cos(theta); /* Megamax bug!! */ 
m[d][d] = m[3][3] = 1; 

switch (d) { /* Megamax bug */ 

case X: m[2][l] = ZERO - (m[l][2] = sin (theta) ) ; break; 
case Y: m[0][2] = ZERO - (m[2] [0] = sin(theta)); break; 
case Z: m[l][0] = ZERO - (m[0][l] = sin(theta) ) ; break; 

} 

> 

/* 

* matrixjnultiplyO multiplies a and b, leaving the result in "result". 
V 

matrixjultiply(a, b, result) 
register transform a, b, result; 
{ 

register SHORT 1, 3; 

for (i =0; i <= 3; i++) for (j = 0; j <= 3; 3++) 

result[i][j] = a[i] [0]*b[0] [j] + a[i] [l]*b[l] [j] + 
a[i][2]*b[2][j] + a[i)[3]*b[3][j]; 

) 

Progiam 11-7. sphere.c 

/* 

* procram to generate a zbuf data file which looks like a good sphere 
V 

| include <stdio.h> 



extern double sin() , cos(), sgrt() ; 
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extern int atoi() ; 

FILE *outfile; 

main(argc, argv) 
int argc; 
char *argv[] ; 

float theta, alpha, th_step, al_step; 
int i, j, res; 

if (argc != 2) { 

rprintf (stderr, "usage: sphere <number of polygons>\n") ; 
exit(l) ; 

) 

res = atoi(argv[l]) ; 
if (res < 8) { 

fprintf (stderr, "too few polygons, must be at least 8.\n"); 
exit(l) ; 

) 

res = (int) sqrt( (double) res) ; 

if ((outfile = fopen("nsphere", "w")) = NULL) { 

fprintf (stderr, "Couldn't open nsphere as output file\n") ; 

exit(l) ; ■ 

) 

th_step = 6.283 / res; 
al_step = 3.1415 / res; 

for C i * 0- theta = 0.0; i < res; i++, theta += th_step ) ( 
fprintf (outfile, "3\tl\n") ; 
point(0.0, theta); 
point (al_step, theta) ; 
point (al_step, theta + th_step) ; 

for ( j = 1, alpha = al_step; j < (res - 1) ; alpha += al_step ) 

for ( i = 0, theta = 0.0; i < res; i++, theta += th_step ) { 

fprintf (outfile, "4\tl\n") ; 

point (alpha, theta); 

point (alpha + al_step, theta) ; 

point(alpha + al_step, theta + th_step) ; 

point (alpha, theta + thstep) ; 

for ( i = 0, theta = 0.0; i < res; i++, theta -f= th_step ) { 
fprintf (outfile, "3\tl\n") ; 
pointfalpha, theta) ; 
point(alpha, theta + th_step) ; 
point(alpha + al_step, theta) ; 

) 

f close ( outfile) ; 

) 

point (al, th) 
float al, th; 

fprintf (outfile, "% . 4f\t% . 4f\t% . 4f\n" , 
(float) (cos(th)*sin(al)), 
(float) cos(al) , 
(float) (sin(th)*sin(al) ) ) ; 

) 
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Ill "thlS chapter we'll be discussing how to render com- 
plex three-dimensional objects. The cube program allowed us 
to focus on the fundamental, mathematical issues of three- 
dimensional perspective: matrix transforms and parallel and 
perspective rendering. In this chapter we'll be focusing more 
on the techniques of displaying an image. 



Hidden-Surface Routines 

There are many ways to handle the general-case problem of 
removing hidden surfaces. With the cube in the last chapter, it 
was possible to derive a simple algorithm to determine which 
face was visible; the general case is much more difficult. In 
this chapter, we'll discuss one of the simplest techniques, the 
so-called z-buffer algorithm. 

There are two major questions to be considered for hidden- 
surface elimination routines: which polygons (and what parts 
of each) to display on the screen, and how to shade the poly- 
gons. We'll be using the simplest possible methods to accom- 
plish both of these goals, but the work is still not trivial. 

Illumination Models 

Let's begin by tackling the question of how to illuminate a 
given polygon. In cube it was easy; we were using color, and 
assuming that the cube was being lit from all sides. In the 
more typical case, however, there is a light source (possibly 
more than one) illuminating the various polygons. 

Light interacts with surfaces in widely varying ways. 
Some surfaces absorb all light: "black bodies." Some reflect 
different amounts of light at different frequencies, making 
them appear various colors. Some reflect light very precisely, 
like mirrors, while other surfaces, like wood, reflect incident 
light randomly, making them appear uniformly illuminated. 

There are two fundamental kinds of reflected light: the 
diffuse reflection, and the specular reflection. Diffuse reflection 
is the ordinary lighting that an object has when it's in the 
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* sort lis; pointed to by p into pairs of x-sorted edges 



*/ 

static void sort_list (base) 
register ecge *base; 



( 



recister SHORT id = -1; 
register edge *next; 
recister SHORT x; 
recister edge *p; 
register SHORT intensity 
register edge *xmin; 



0; 



/* id of polygon edge to match */ 

/* edge under scrutiny */ 

/* nunimum x-value in search */ 

/* search pointer */ 

/* we're looking for low intensity */ 

/* pointer for smallest edge */ 



for ( 



base->next; base = base->next) { 
x = 0x7fff ; /* largest possible short 

for (p " xmin = base; next = p->next; p = next) { 
if (id != -1 && next->id != id) continue; 
if (next->x > x) continue; 

if (next->x = x && next->intensity > intensity) 

continue; 
x = next->x; 

intensity = next->intensity; 
xmin = p; 

) 

p = xmin->next; 
if (xmin S= base) ( 

xmin->next = p->next; 

p->next = base->next; 

base->next = p; 



V 



/* delete it from list, 
/* chain it in ahead, 
/* & chain it in from behind */ 



V 
V 



id = (id = -1) ? p->id : -1; /* toggle id 



*/ 



if (id != -1) punt("sort_list: orphaned edge"); 



/ 



* run threugh the active list to set up the frame buffer, which is returned. 



V 

static SHOIT *make_buffer(p) 
register edge *p; 

( 

recister long *zp; 
recister SHORT ♦fo- 
recaster long z; 
recister SHORT x; 
recister SHORT x_end; 
loig z_buf fer[MAXPIXEI£] ; 



/* pointer to the z-buf fer */ 
/* pointer into frame buffer */ 
/* current line's current z-pos */ 
/* current line's current x-pos */ 
/* end of x-span */ 
/* holds z-ooord of each pixel */ 



stitic SHORT frame_buffer[MAXPIXELS] ; /* ..intensity of each pix=l */ 
foi (zp = z_buffer, fp = frairebuffer, x = x_size; x; -H-zp,++fp,~x) { 



*zp = Z_MAX; 
*fp = BIACK; 

} 

while (p) { 

x = p->x; 

z = p->z; 

p = p->next; 

x_end = p->x; 

zp = &z_buf fer[x] ; 

fp = &frame_buffer[x] ; 



/* z_buf fer is far away */ 
/* frame_buf fer is background color */ 

/* can't directly modify these two */ 

/* pull off other edge of pair */ 

/* use pointers, not array indices */ 
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for (; x <= x_end; ++x, ++zp, ++fp, z += p->zx) 
if (z < *zp) { 

*zp = z - Z_0DL; /* set z_buffer */ 

*fp = p->intensity; /* . . franebuffer */ 

p = p->next; 

> 

return frame_buffer; /* let the world know about our work */ 

/* 

* display frame buffer 
*/ 

static void write_scanline( frame, y) 

register SHORT *frame; /* pointer to start of frame buffer */ 

register SHORT y; /* current pixel line */ 

register SHORT x; /* current pixel column */ 

register SHORT intensity; /* intensity of current span */ 

register SHORT x_end = x_size - 1; /* last pixel on row */ 

move ((SHORT) 0, y) ; /* start drawing at left */ 

set_pen( intensity = *frame) ; 
for (x = 1; x <= x_end; ++x) 

if (*++frame != intensity) { 

draw(x, y) ; /* draw one too far */ 

set_pen(intensity = *frame) ; 

} 



) 



draw(x_end, y) ; 



/* 

* update active list 
*/ 

static edge *update_list (p) 
register edge *p; 

{ 

register edge *next; /* edge being examined */ 

register SHORT x_sign; /* registers to speed things up . . */ 

register SHORT x_base; 

register long zx; 

while (next = p->next) 

if (— (next->len) < 0) { /* line is negative length */ 

p->next = next->next; /* chain over it . . */ 

free ((char *) next); /* and free its memory */ 



) 

else { 



} 

return p; 



if ( (next->x_frac ~= next->x_add) < 0) { ' 

x_sign = next->x_sign; /* use registers! */ 
x_base = next->x_base; 
zx = (x_sign > 0) ? next->zx : -next->zx; 
do ( 

next->x += x_sign; 
next->z ■+« zx; 
) while ((next->x_frac += x_base) < 0) ; 

) 

next->z += next->zy; 
p = next; 
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nearer to us than the corresponding value in the deptn 
buffer— that is, if 

ai.tana.-to-poiut < awtiuJmaMWM) 

we pint an appropriately colored pixel 

sometanes the later polygons don t appeM _on mes 

SS. -S. ^d^'vaiues are "buffered" while the 
^S^i ** ^chnique is that it takes a lot 

bytes per pixel; and with 25 000 pixe s, ^ 

up the enttre memory of a 1040b 1, wnn , n 

sSeea, program ""^ S,i " 

concept remains much the same. 

•dxawO are used to define «« «^ , he „.„ modu l e , 
P^a^ttSfitTm^w the polygons it knows 
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about on the display. Both area_amoveC ) and area_adrawC ) 

do, of course, take three parameters, rather than the two of 
area move( ) and area — drawC ) 

We'll be returning to these area_z routines fairly soon, 
when we've smoothed out some of the details of data struc- 
tures and perspective transformations. 

Data Files for zbuf 

Our next program will have the ability to display arbitrary 
polygons. To do this, of course, we need to have some way of 
specifying arbitrary polygons. The simplest method is to return 
to the data-file approach of the first graphics program we 
wrote, polygons (see Chapter 8). We can no longer specify 
each polygon with a two-item header (number of vertices and 
intensity) followed by a list of coordinate pairs, as we did 
before. Rather than an absolute intensity value, we'll specify a 
value for k<i (and k a , since we're treating them the same). The 
header will then be followed by n coordinate triples, x, y, and 
2. The idea is much the same. 

The data structure that we'll read these points into is 
fairly basic. The basic unit is, of course, the vector, which 
we've been using all along. However, it won't do to just load 
our data into a vector and then start transforming it: We'll lose 
the original, world-coordinate data. So, we define a structure 
called an Ivector (Program 11-1) which has two fields, a and 
w, the "archive" and the "working" copy of the vector: 

typedef struct Ivector { /* a Sspace point •/ 
struct Ivector *next; 

vector a; /' archive copy of vector •/ 

vector w; /* work copy of vector •/ } ivector; 

Notice that the Ivector structure has one additional field, a 
next field to point to another Ivector structure. This allows 
the vertices of a polygon (represented by Ivectors) to # be linked 
into a list. 

The polygons, too, have a fairly simple structure. They 
are linked into a list, which is built when the data file is first 
read into memory. Each polygon also has an ivector pointer 
to its list of vertices, a k a field for its diffuse reflectivity con- 
stant, a normal field to store its normal (which is computed 
when the polygons are being loaded), and an intensity field 
which holds the most recently computed intensity value of the 
polygon: 
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V 

transform t get_crt_transfonn() 

{ 

^^-^ « /* again static, returned v 

register ipoly *poly; 
register FLOAT scale, usize, vsize; 
register float umin, umax, vmin, vmax, zmin, z^x,. 

* define SCALE_DOWN .8 

- ™Jn " « leflO; /* arbitrary large v 
umax = vmax = zmax = -le+10; »"j.«=> / 

for (poly = poly_list; poly; poly = poly->next) 
for (v = poly->vertex; v; v = v->next) { 

if (v->w[X] < umin) umin = v->w[X] ; 
if (v->w[X] > umax) umax = v->w[X] ; 
if (v->w[Y] < vmin) vmin = v->w[Y] ; 
if (v->w[Y] > vmax) vmax = v->w[Y] ; 
if (v->w[Z] < zmin) zmin = v->w[Z] ; 
j if (v->w[Z] > zmax) zmax = v->w[Z] ; 

usizs = umax - umin; 
vsizs - vmax - vmin; 
if (usize «= 0 1 1 vsize — 0) 

punt("get_crt_transform: zero-size imaae' "\ ■ 
^ P lf TJ / iZe/USiZe< ™ size^e) ) ? 
amt'n^ 26 C ^ : (FLQAT) size / w*i*e> * SCALE DOWN- 
a 3 J O] = - umin * scale + ( (FLOAT) x size - scale *^ew',. 

" Y*?* * scale + ( (FLOAT) y size - scale * vsizef / 2- 
ari] 1 - ZERO - (a[0][0] = scale); - ' 7 2 ' 

a[2] 2] - (FLOAT) Z MAX / (zmax - zmin) • /* o~, n 

a[3] [2] ■= ZERO - (ziin /. Z), 1 ' /* scale depth */ 

) return (transform *) a; J ' 

Program ]l-5. poly.c 

/* 

** ^:'L harai f S **** TOrk of transforming polygons into 

* plotted scanlines of the correct intensity. 

#include "madiine.h" 
# include "baa.h" 

/* 

* ^ ^l^^t^ to track ° f the borders of the polygons 

* tte^L!?? S"" ^fj"^ structure contains a pointer to 

* x^^^ f 396 '' fiVe ^^es that allow us to conpute toe 

* x S aS fbS^ 00 I™ 30 **** fx, x frac^TstgT 

* vJw'J^ ;^T ) ' 011:66 l0ngs ' 2 ' zx > containing the current 

* a^R? ^ ^ ^ Z the line moveTi^x or S^and 

* ri J ,^^i^ aiJm,g **** length ° f the line in scanlines (len) ; and same^ 
: polygon? *° ^ id -dVintonsr^of 
*/ 

typedef struct Edge { 

structBdge *next; /* next edge on the active edge list */ 
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SHORT x; 
SHORT x_frac; 
SHORT x_sign; 
SHORT x add; 
SHORT x_base; 
long z; 
long zx; 
long zy; 
SHORT len; 
SHORT intensity; 
SHORT id; 



) edge; 



current x position */ 
pixel fraction (x_frac/x_base) */ 
1 or -1 (direction of line) */ 
fraction we move on each pixel line */ 
unit scaling base for x_frac */ 
z-locatian */ 

rounded-down delta z for each delta x */ 
ditto, for each delta y */ 
/* length of line (in scanlines) */ 
/* intensity of polygon we're a line of */ 
/* id number of this polygon */ 



/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 



* Vertex structures are used to keep track of global vertices— the current 

* position of the "cursor"; the position of the initial vertex (so we can 

* connect the polygon when we have all the vertices) ; and two vertices 

* marking the beginning and end of the first line (which is ignored the 

* first time through the polygon and needs to be specially handled) . 
*/ 

typedef struct Vertex ( 

SHORT x; 

SHORT y; 

long z; 
) vertex; 

/* Z_TOL is the z "tolerance", i.e. how far apart two points need to be to */ 
/* be considered as actually differentiable. Needed for close decisions. */ 
#define Z TOL 0x7fff 



/* variables global to the poly module */ 



static edge *line[MAXUNE] ; 

static vertex pos; 
static vertex init; 
static vertex edgel; 
static vertex edge2; 
static vector normal; 

static SHORT current_id; 
static SHORT poly_stat = 0; 
static SHORT poly_intensity; 
static void close_polygon() ; 



/* 



/* scanline array of starting edges */ 

/* current position of cursor */ 

/* start-point of polygon */ 

/* start-point of 1st non-horiz edge */ 

/* end-point of same edge */ 

/* normal vector to polygon */ 

/* id counter for polygons */ 
/* current state of polygon draw */ 
/* intensity of the current polygon */ 
/* predefine for the compiler */ 



* the area_zmove() routine simply sets the beginning of the first of 

* a series of area_zdraw() commands. If poly_stat is set, then we've 

* just finished drawing a polygon, so we call close_polygon() to ' 

* tidy up. The initial vertex (init) , the current vertex (pos) , and the 

* normal are saved, and the polygon id tag is incremented (current_id) . 
*/ 

void area_zmove(x, y, z, n) 
FLOAT x, y, z; 
vector *n; 

{ 



extern SHORT intensity; 



1) close_polygon() i 



if (poly_stat ■ 
poly_stat = 0; 
poly_intensity = intensity; 
init.x = pos.x = (SHORT) x; 
init.y - pos.y = (SHORT) y; 



/* close last polygon */ 
/* reset polygon status */ 

/* save vertex */ 



Chapter 11 



by the iet_ intensities routine, further down in display.c, at 

the verj beginning and then every time the light source is 
moved.) Then we pass the first vertex to area .zmove( ). Now 
we scan through the remainder of the vertex list, calling 
area_zirawO for each one. Finally, when we've drawn ev- 
ery polygon, we call area_zend() to wrap things up and dis- 
play all the polygons. 

Seieral other routines are included in display.c. The 
compule— normalC ) routine is passed three points and an ini- 
tialized vector. The routine takes the two edges formed by the 
three vertices and assigns the passed vector (the normal) to 
their ncrmalized cross product. 

Ths other function is set— intensitiesC ), which computes 
the Lambert's Law intensity of all the polygons. The intensity 
is set tc kd times I a (the global variable which holds the am- 
bient intensity, ranging from 0.0 to 1.0). ka is here equal to 
k a . Then we examine the normal of the polygon's plane. If it's 
facing nore or less in our direction (that is, if the dot product 
of the Light and the cop is greater than 0), then the normal is 
facing the right way. Otherwise, the normal is pointing the 
wrong way (180 degrees reversed), and we use scale— copy— 
vectorO to multiply it by —1. We have to have the normal 
facing ls when we compute its angle with the light source, 
since the side of the polygon facing us is the side that we're 
going to see. 

Nov we take the dot product of the light source and the 
normal In the code, we don't directly use the cosO routine to 
get the intensity, which is what Lambert's Law prescribes; in- 
stead, ve use the dot product, which is the same as the cosine 
for vectors of length 1 . If this dot product (which we set to 
temp) is greater than 0, the light source is in a position to illu- 
mine this side of the polygon, and we increase the illumina- 
tion to t<i • temp. Now we've expressed Lambert's Law, but 
we neei to make sure the resulting intensity is between 0.0 
and 1.0 Values greater than 1.0 are set to 1.0; that way, we 
can mate sure that an ambient intensity of 1.0 will flood the 
picture with light, as will direct light on a properly aligned 
polygon. The intensity is scaled to max— intensity before be- 
ing savtd in the "intensity" field of the polygon, so that it can 
be dirertly passed to the set— penC ) routine. 
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The poly.c Module 

Now we have to tackle the actual mechanism of the z-bulter 
polygon plotting code. We've already gone over the basic 
techniques used in the z-buffer algorithm; now we can estab- 
lish how to code the algorithm itself. 

The area-amoveC ) routine is very similar to the axea_ 
moveO routine. Both routines have a simple task to perform: 
save the passed arguments for the first call to the area-draw 
routine. The area_sdrawO routine is more complicated. Ihe 
arguments which are passed to it are all floats, so we have to 
convert them into shorts and longs before we can use them. 
The routine is very similar to the area_moveC ) routine, al- 
though the extra, z component makes things appear a little 

more complex. „,-,•, -j • i 

In the new edge structure, most of the fields are identical 
to the ones from area-moveO- The new fields are m, «, and 
ay When we discussed the z-buffer algorithm above, we said 
that we would calculate the z coordinate for each point in the 
polygon. However, actually performing the calculations with 
the polygon's plane function would be extremely slow. So, we 
will emulate the line-draw routine, and calculate the z value 
incrementally. The plane equation, which we mentioned 
above, is 

Ax + By+Cz + D = 0 

Solving this for z, we get 

— D — Ax — By 
z — 

C 

However, if we assume that at the beginning of a poly- 
gon's segment on a specific scan line, the z value is z 0 , we can 
easily calculate the z value at successive points (i + Ax, y) on 
the scan line: 

z = z 0 A Ax 
C 

Since A/C is a constant, and each successive A x is equal 

to 1, we can incrementally compute the z position as we move 

across the scan line. This value, A/C, is stored as zx. 
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size = (x_size < y_size) ? x_size : y_size; 

cop[H] = vrp[H] = vpn[H] - vup[H] = lightfH] = 1; 

vup[X] = 0; vup[Y] = 1; vup[Z] = 0; /* set vup */ 

cop[X] = 0; cop[Y] = 0; cop[Z] =1; /* cap */ 

vpi[X] = 0; vpn[Y] = 0; vpn[Z] = -0.5; /* vpn */ 

vrp[X] = 0; vrp[Y] = 0; vrp[Z] = 0.5; /* and vrp */. 

light[X] = l; light[Y] = 0; light[Z] = 0; /* dir to light source */ 

/* get data file */ 
if (argc != 2) 

punt("syntax: zbuf datafile") ; 
read_i»lygon_data ( argv [ 1 ] ) ; 
set_intensities() ; 

/* start off displaying picture */ 
display_update() ; 
/* input loop */ 
for (;;) { 

if (get_input (input) = NULL) break; 

if (*input >= 'A' && *input <= 'Z') *input += ('a' - 'A'); 
if (parse(input[0], &input[l])) break; 

exit jgrariiics (NULL) ; 



/* 

* pass this function the command and its arguments (a char and a strong) . 

* It parses the command and executes it. If it gets a 'q' command, it 

* returns one; otherwise it returns zero. 
V 

int parse (c, s) 
register char c, *s; 

float x, y, z- theta, n; /* command line input variables */ 
switch (c) { 

case 'a': /* set absolute position of OOP */ 

if (sscanffs, "%f%f%f", &x, &y, &z) != 3) 

printf ("syntax: a x-pos y-pos z-pos\n") ; 
else cop_locate(x, y, z) ; 

case 'x' : /* rotate around x, y, or z axes */ 

case 'y': 
case ' z ' : 

if (sscanf(s, "%f%f", itheta, in) != 2) 

printf ("syntax: %c angle number-of-steps\n",c) 

else if (n <= 0) 

printf ("number of steps must be positive !\n") ; 

else cop_rotate(c, theta, n) ; 

break; 
case 'f ' : 

fill = !fill; /* toggle fill / wire mode */ 

redraw_display() ; 

break; 

case 'i 1 : /* ambient intensity */ 

if (sscanf(s, "%f", in) != 1) { 

printf ("syntax: i ambient_intensity\n") ; 
break; 

} 

if (n < 0.0 | | n > 1.0) { 

printf ("i: intensity must be 0.0 to 1.0\n") ; 
break; 
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case 



printf ("A x y z 
printf ("X angle nsteps 
printf ( "Y angle nsteps 
printf ("Z angle nsteps 
printf ("I intensity 
printf ("L x y z 
printf ( "R 
printf ("F 
printf ("W 
printf ("Q 
printf ("H -or- ? 



) 

ia = n; 

set_intensities() ; 

if (fill = 1) display_update() ; 

break; 

case '1': /* direction to light */ 

if (sscanf(s, "%f%f%f", ix, &y, &z) != 3) { 

printf ("syntax: 1 x-pos y-pos z-pos\n") ; 
break; 

) 

light[X] = x; light[Y] = y; light[Z] = z; light[H] = 

divide_vector(light, magnitude (light) ) ; 

set_intensities() ; 

if (fill = 1) display_update() ; 

break; 

'r': /* redraw display */ 

redraw_display() ; 
break; 

' w ' : /* where is everything? */ 

printf ("ambient light intensity is %g\n", ia) ; 
printf ("light source is at (%g,%g,%g)\n", 

light[X], light[Y], light[Z]); 
printf ("cop is at (%g,%g,%g) \n",cop[X] ,cop[Y] ,cop[Z] ) 
break; 
EOF: 

case 'g': /* all done */ 

return 1; 
case '?' : 
•h': 

specify absolute coordinates for OOP\n") ; 
rotate OOP around x axis\n") ; 
rotate OOP around y axis\n") ; 
rotate OOP around z axis\n") ; 
set ambient light intensity (0.0 to 1.0) \n") ; 
set absolute coordinates for light source\n") ; 
redraw display\n") ; 

toggle fill-mode / wire-mesh display\n") ; 
where are we (status output) \n") ; 
guit\n") ; 

display this help list\n") ; 
break; 



*\0' 



default: 



) 

return 0; 



break; 

printf ("unknown command '%c'\n", c) ; 



/* 

* The 'a' command relocates the OOP. This function 

* adjusts OOP, sets VRP to OOP/2, and VPN to -VRP. VUP is hacked; 

* it points to +y all the time except when it's on the y-axis, 

* when we hack it to point to +x. 

V 

ccp_locate(x, y, z) 
float x, y, z; 

( 

cop[X] = x; cop[Y] = y; cop[Z] = z; /* set cop */ 

divide_vector(cop, magnitude (cop) ) ; 

scale_copy_vector(eop, vrp, 0.5); /* .. vrp */ 
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sise = (x_size < y_size) ? xsize : y_size; 

ccd[H] = vrp[H] = vpn[H] = vup[H] = light[H] = 1; 

wp[X] = 0; vup[Y] = 1; vup[Z] = 0; /* set vup */ 

ceppq = 0; ccp[Y] « 0; cop[Z] = 1; /* ccp */ 

vpipq = 0; vpn[Y] = 0; vpn[Z] = -0.5; /* vpn */ 

vd[X] = 0; vrp[Y] = 0; vrp[Z] = 0.5; /* and vrp */ 

l%ht[X] = l; light[Y] = 0; light [Z] = 0; /* dir to light source */ 

/* get data file */ 
if (argc != 2) 

punt("syntax: zbof datafile") ; 
rrad_polygon_data(argv[l]) ; 
set_intensities() ; 

/* start off displaying picture */ 
display_update() ; 
/* input loop */ 
for (;;) { 

if (get_input( input) = NOTi) break; 

if (*input >= 'A' && *input <= 'Z') *input += ('a' - 'A'); 
if (parse(input[0], iinputfl])) break; 

} 

eM.t_graphics(NULL) ; 



/* 

* pass ttis function the command and its arguments (a char and a string) . 

* It parses the command and executes it. If it gets a 'q' command, it 

* returns one; otherwise it returns zero. 
*/ 

int parse c, s) 
register char c, *s; 

float x, y, z- theta, n; /* command line input variables */ 
ssitch (c) { 

case 'a' : /* set absolute position of OOP */ 

if (sscanf(s, "%f%f%f", &x, iy, fiz) != 3) 

printf ("syntax: a x-pos y-pos z-pos\n") ; 
else cop_locate(x, y, z) ; 
break; 

case 'x': /* rotate around x, y, or z axes */ 

case 'y' : 

CaSE Z if (sscanf (s, "%f%f", itheta, to) != 2) 

printf ("syntax: %c angle number-of-steps\n",c) ; 
else if (n <= 0) 

printf ("number of steps must be positive! \n") ; 
else cop_rotate(c, theta, n) ; 
break; 
case 'f'l 

fill = I fill; /* toggle fill / wire mode */ 

redraw_display() ; 

break; 

case 1 i 1 : /* ambient intensity */ 

if (sscanf (s, "%f", in) != 1) ( 

printf ("syntax: i ambient_intensity\n") ; 
break; 

) 

if (n < 0.0 | | n > 1.0) { 

printf ("i: intensity must be 0.0 to 1.0\n"); 
break; 
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) 

ia = n; 

set_intensities() ; 
if (fill = 1) display_update() ; 
break; 

/* direction to light */ 
if (sscanffs, "%f%f%f", ix, &y, fiz) 1= 3) ( 

printf ("syntax: 1 x-pos y-pos z-pos\n") ; 
break; 

} 

light [X] = x; light[Y] = y; light[Z] = z; light [H] = 1; 
divide_vector(light, magnitude (light) ) ; 
set_intensities() ; 
if (fill = 1) display_update(); 
break; 

'r': /* redraw display */ 

redraw_display() ; 
break; 

case 'w': /* where is everything? */ 

printf ("ambient light intensity is %g\n", ia) ; 

printf ("light source is at (%g,%g,%g)\n", 
lightfX], light[Y], light [Z]) ; 

printf ("cop is at (%g,%g,%g) \n",cop[X] ,cop[Y] ,cop[Z] ) ; 

break; 
case EOF: 

case 'q': /* all done */ 

return 1; 
case 1 ? 1 : 
case 'h' : 

printf ("A x y z specify absolute coordinates for C0P\n") ; 

printf ("X angle nsteps rotate OOP around x axis\n") ; 

printf ("Y angle nsteps rotate OOP around y axis\n") ; 

printf ("Z angle nsteps rotate OOP around z axis\n") ; 

printf ("I intensity set ambient light intensity (0.0 to 1.0)\n"); 

printf ("L x y z set absolute coordinates for light source\n") ; 

printf ("R redraw display\n") ; 

printf ("F toggle fill-mode / wire-mesh display\n") ; 

printf ("W where are we (status output) \n") ; 

printf ("Q quit\n") ; 

printf ("H -or- ? display this help list\n") ; 

break; 
case '\0': 

break; 

default: 

^ printf ("unknown command '%c'\n", c) ; 

return 0; 

) 

/* 

* The 'a' command relocates the OOP. This function 

* adjusts OOP, sets VRP to OOP/2, and VPN to -VRP. VUP is hacked; 

* it points to +y all the time except when it's on the y-axis 

* when we hack it to point to +x. 

V 

coplocatefx, y, z) 
float x, y, z; 

( 

cop[X] = x; cop[Y] = y; cop[Z] = z; /* set cop */ 

divide_vector(ccp, magnitude (cop) ) ; 

scale_copy_vector(eop, vrp, 0.5); /* . . vrp */ 
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by the tet— intensities routine, further down in display.c, at 

the very beginning and then every time the light source is 
moved.) Then we pass the first vertex to area_zmove( ). Now 
we scan through the remainder of the vertex list, calling 
area_zlrawC ) for each one. Finally, when we've drawn ev- 
ery polygon, we call area_zendC ) to wrap things up and dis- 
play all the polygons. 

Several other routines are included in display.c. The 
compute— normalC ) routine is passed three points and an ini- 
tialized vector. The routine takes the two edges formed by the 
three vertices and assigns the passed vector (the normal) to 
their normalized cross product. 

The other function is set— intensities^, which computes 
the Lambert's Law intensity of all the polygons. The intensity 
is set to k<i times l a (the global variable which holds the am- 
bient intensity, ranging from 0.0 to 1.0). kfl is here equal to 
k a . Then we examine the normal of the polygon's plane. If it's 
facing more or less in our direction (that is, if the dot product 
of the lght and the cop is greater than 0), then the normal is 
facing the right way. Otherwise, the normal is pointing the 
wrong way (180 degrees reversed), and we use scale— copy— 
vector( ) to multiply it by — 1 . We have to have the normal 
facing us when we compute its angle with the light source, 
since the side of the polygon facing us is the side that we're 
going to see. 

Now we take the dot product of the light source and the 
normal. In the code, we don't directly use the cosC ) routine to 
get the intensity, which is what Lambert's Law prescribes; in- 
stead, we use the dot product, which is the same as the cosine 
for vectars of length 1. If this dot product (which we set to 
temp) is greater than 0, the light source is in a position to illu- 
mine this side of the polygon, and we increase the illumina- 
tion to td * temp. Now we've expressed Lambert's Law, but 
we need to make sure the resulting intensity is between 0.0 
and 1.0. Values greater than 1.0 are set to 1.0; that way, we 
can maxe sure that an ambient intensity of 1.0 will flood the 
picture with light, as will direct light on a properly aligned 
polygon. The intensity is scaled to max—intensity before be- 
ing saved in the "intensity" field of the polygon, so that it can 
be directly passed to the set— penO routine. 
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The poly.c Module 

Now we have to tackle the actual mechanism of the z-butter 
polygon plotting code. We've already gone over the basic 
techniques used in the z-buffer algorithm; now we can estab- 
lish how to code the algorithm itself. 

The area-zmoveC ) routine is very similar to the area- 
moveO routine. Both routines have a simple task to perform: 
save the passed arguments for the first call to the area-draw 
routine. The area_sdrawO routine is more complicated. The 
arguments which are passed to it are all floats, so we have to 
convert them into shorts and longs before we can use them. 
The routine is very similar to the area_moveC ) routine, al- 
though the extra, a component makes things appear a little 

more complex. 

In the new edge structure, most of the fields are identical 
to the ones from area-moveC )• The new fields are >, wx, and 
zy When we discussed the z-buffer algorithm above, we said 
that we would calculate the z coordinate for each point in the 
polygon However, actually performing the calculations with 
the polygon's plane function would be extremely slow. So, we 
will emulate the line-draw routine, and calculate the z value 
incrementally. The plane equation, which we mentioned 
above, is 

Ax + By + Cz + D = 0 

Solving this for z, we get 

— D — Ax — By 
z = 

C 

However, if we assume that at the beginning of a poly- 
gon's segment on a specific scan line, the z value is z 0 we can 
easily calculate the z value at successive points (x + A x, y) on 
the scan line: 

z = z 0 _A_ A x 
C 

Since A/C is a constant, and each successive A x is equal 

to 1, we can incrementally compute the z position as we move 

across the scan line. This value, A/C, is stored as zx. 
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*/ 

transform t get_crt_transfonn() 

( 

5£?±S5£ 2, 7 * ^ ^ ^turned V 

register ipoly *poly; 

register FLOAT scale, usize, vsize; 

register FLOAT umin, umax, vmin, vmax, zmin, zmax; 

# define SOLEJXWN .8 

for (poly = pol y _list; poly; poly = poly->next) 
for (v « poly->vertex; v; v = v->next) { 

if (v->w[X] < umin) umin = v->w[Xl ; 
if (v->w[X] > umax) umax = v->w[X] ; 
if (v->w[Y] < vmin) vmin = v->w[Y] ■ 
if (v->w[Y] > vmax) vmax = v->wrYl • 
if (v->w[Z] < zmin) zmin = v->w[zi- 
^ xf (v->w[Z] > zmax) zmax = v->w[Z] '; 

usizs = umax - umin; 
vsiza = vmax - vmin; 
if (jsize — 0|| vsize — o) 

Sip- ss '. as ; s.-^Ta: rae-v 

Si ii : ffi?? •• /* — •/ 

( return (transform *) a; 

Program 31-5. poly.c 

/* 

** S > ^ hanU f S ^ !? ly HQek of transforming polygons into 

* plotted scanlines of the correct intensity. 

/ 

♦include "maciine.h" 
# include "bast.h" 

/* 

* « Ze^E^** ^ to keep track of the borders of the polygons 

* ^xf^e^^ ^ S 9 " structure stains a pointed to 

* x^osiSon £ J£ ' flVe variables that allow us to compute the 
x position of the line on successive scanlines fx x frac jT^ior, 

> z ' £ -d zy, 'conta^ ^Srrent 

* aSKOT JIT? fS f tS Z takes the line moves in x or in y and 

* cL^ 1 ^S 1 i Un ?K the ^ en9th of toe line « scanlines (len) ; and soJT 

* ^pSygonf to (the P 01 ^ 0 " id nu *^ and l the ; intens^Tof 
V 

typedef struct Edge { 

struct Edge *next; /* next edge on the active edge list */ 
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) edge; 



SHORT x; 


/* 


SHORT x_frac; 


/* 


SHORT x sign; 


/* 


SHORT x add; 


/* 


SHORT x base; 


/* 


long z; 


/* 


long zx; 


/* 


long zy; 


/* 


SHORT len; 


/* 


SHORT intensity; 


/* 


SHORT id; 


/* 



current x position */ 
pixel fraction (x_frac/x_base) */ 
1 or -1 (direction of line) */ 
fraction we move on each pixel line */ 
unit scaling base for xfrac */ 
z-locaticn */ 

rounded-down delta z for each delta x */ 
ditto, for each delta y */ 
length of line (in scanlines) */ 
intensity of polygon we're a line of */ 
id number of this polygon */ 



/* 

* Vertex structures are used to keep track of global vertices — the current 

* position of the "cursor"; the position of the initial vertex (so we can 

* connect the polygon when we have all the vertices) ; and two vertices 

* marking the beginning and end of the first line (which is ignored the 

* first time through the polygon and needs to be specially handled) . 
*/ 

typedef struct Vertex { 

SHORT x; 

SHORT y; 

long z; 
) vertex; 

/* Z_TOL is the z "tolerance", i.e. how far apart two points need to be to */ 
/* be considered as actually differentiable. Needed for close decisions. */ 
#define ZJTOL 0x7fff 

/* variables global to the poly module */ 

static edge *line[MAXI2NE] ; /* scanline array of starting edges */ 

static vertex pos; /* current position of cursor */ 

static vertex init; /* start-point of polygon */ 

static vertex edgel; /* start-point of 1st non-horiz edge */ 

static vertex edge2; /* end-point of same edge */ 

static vector normal; /* normal vector to polygon */ 

static SHORT current_id; /* id counter for polygons */ 

static SHORT poly_stat =0; /* current state of polygon draw */ 

static SHORT poly_intensity; /* intensity of the current polygon */ 

static void close_polygon() ; /* predefine for the compiler */ 

/* 

* the area_zmove() routine simply sets the beginning of the first of 

* a series of area_zdraw() commands. If poly_stat is set, then we've 

* just finished drawing a polygon, so we call close_polygon ( ) to ' 

* tidy up. The initial vertex (init) , the current vertex (pos) , and the 

* normal are saved, and the polygon id tag is incremented (current_id) . 
*/ 

void area_zmove(x, y, z, n) 
FLOAT x, y, z; 
vector *n; 

{ 

extern SHORT intensity; 

if (poly_stat = l) close_polygon ( ) ; /* close last polygon */ 
poly_stat =0; /* reset polygon status */ 

poly_intensity = intensity; 

init.x = pos.x = (SHORT) x; /* save vertex */ 

init.y = pos.y - (SHORT) y; 
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nearer to us than the corresponding value in tne u F 
buffer— that is, if 

dl8tarce_to_point < deptH-buff er W [y]; 

we plct an a^d^^^^^^ 
and u,date the dept hbufeto* e just p ^ ^ 

* e st to u are Sot S on^e P sJe g en. Some polygons are 

sometmes the later polygons don ^PP^J^ that has 
if they're further away and n the same plac^ ^ ^ 

^K^SS this technique is that it takes a lot 
example the Atar s MUA informa tion, that's four 

buffer, using only 16-bit ^s t or aepm memory . 

r0 u*es that we've already the 
to display the polygons We can use sue ' a ted*^ ^ 
z-bufer method as well; then all we neea 

concept remains much the same. 

dimensional cousins we 11 be "Umg me m u of 

arei-sdrawO, and area_zendC )• I he Dasic iu a ; 

»4nwO are used to define the tn ™ e h - oly . 0 module, 
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about on the display. Both area_zmoveC ) and area—sdrawC ) 

do, of course, take three parameters, rather than the two of 
area— moveC ) and area_drawC ). 

We'll be returning to these area_z routines fairly soon, 
when we've smoothed out some of the details of data struc- 
tures and perspective transformations. 

Data Files for zbuf 

Our next program will have the ability to display arbitrary 
polygons. To do this, of course, we need to have some way of 
specifying arbitrary polygons. The simplest method is to return 
to the data-file approach of the first graphics program we 
wrote, polygons (see Chapter 8). We can no longer specify 
each polygon with a two-item header (number of vertices and 
intensity) followed by a list of coordinate pairs, as we did 
before. Rather than an absolute intensity value, we'll specify a 
value for ka. (and k a , since we're treating them the same). The 
header will then be followed by n coordinate triples, x, y, and 
z. The idea is much the same. 

The data structure that we'll read these points into is 
fairly basic. The basic unit is, of course, the vector, which 
we've been using all along. However, it won't do to just load 
our data into a vector and then start transforming it: We'll lose 
the original, world-coordinate data. So, we define a structure 
called an Ivector (Program 11-1) which has two fields, a and 
w, the "archive" and the "working" copy of the vector: 

typedef struct Ivector { /' a 3space point */ 
struct Ivector "next; 

vector a; /' archive copy of vector •/ 

vector w; /* work copy of vector '/ } ivector; 

Notice that the Ivector structure has one additional field, a 
next field to point to another Ivector structure. This allows 
the vertices of a polygon (represented by Ivectors) to^ be linked 
into a list. 

The polygons, too, have a fairly simple structure. They 
are linked into a list, which is built when the data file is first 
read into memory. Each polygon also has an ivector pointer 
to its list of vertices, a k a field for its diffuse reflectivity con- 
stant, a normal field to store its normal (which is computed 
when the polygons are being loaded), and an intensity field 
which holds the most recently computed intensity value of the 
polygon: 
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* sort list pointed to by p into pairs of x-sorted edges 



V 

static void sort_list (base) 
register edge *base; 

{ 

register SHORT id = -1; 

register edge *next; 

register SHORT x; 

register edge *p; 

register SHORT intensity = 0; 

register edge *xmin; 



/* id of polygon edge to match */ 

/* edge under scrutiny */ 

/* minimum x-value in search */ 

/* search pointer */ 

/♦we're looking for low intensity */ 

/* pointer for smallest edge */ 



for (; base->next; base 
x = 0x7fff ; 
for (p = xmin = 
if (id 



= base->next) ( 

/* largest possible short 
base; next = p->next; p = next) ( 
!= -1 £.& next->id != id) continue; 



V 



if (next->x > x) continue; 

if (next->x = x && next->intensity > intensity) 

continue; 
x = next->x; 

intensity = next->intensity; 
xmin = p; 



) 

p = xmin->next; 
if (xmin != base) { 

xmin->next - p->next; 

p->next = base->next; 

base->next = p; 

id = (id — -1) ? p->id : -1; /* toggle id 
if (id != -1) punt("sort_list: orphaned edge") ; 



/* delete it from list, */ 
/* chain it in ahead, */ 
/* & chain it in from behind */ 



V 



/ 



* ran thrtugh the active list to set up the frame buffer, which is returned. 



*/ 

static SHOE? *make_buffer(p) 
register edge *p; 

( 

register long *zp; 
register SHORT *fp; 
register long z; 
register SHORT x; 
register SHORT xend; 
loig z_buf fer[MAXPIXELS] ; 



/* pointer to the z-buffer */ 
/* pointer into frame buffer */ 
/* current line's current z-pos */ 
/* current line's current x-pos */ 
/* end of x-span */ 
/* holds z-coord of each pixel */ 



static SHORT frame_buffer[MAXPIXEI£] ; /* ..intensity of each pix°.l */ 
foi (zp = z_buffer, fp = frame_buffer, x = x_size; x; ++zp,++fp, — x) ( 



*zp = Z_MAX; 
*fp = BLACK; 

} 

while (p) ( 

x = p->x; 

z = p->z; 

p = p->next; 

x_end = p->x; 

zp = S.z_buf fer[x] ; 

fp = &frame_buffer[x] ; 



/* z_buffer is far away */ 
/* frame_buffer is background color */ 



/* can't directly modify these two */ 

/* pull off other edge of pair */ 

/* use pointers, not array indices */ 
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for (; x <= x_end; ++-x, ++zp, ++fp, z p->zx) 
if (z < *zp) ( 

*zp = z - Z_T0L; /* set z_buffer */ 

*fp = p->intensity; /* . . frame_buffer */ 

p = p->next; 

} 

return frame_buffer; /* let the world know about our work */ 

) 

/* 

* display frame buffer 
*/ 

static void write_scanline(frame, y) 

register SHORT *frame; /* pointer to start of frame buffer */ 

register SHORT y; /* current pixel line */ 

register SHORT x; /* current pixel column */ 

register SHORT intensity; /* intensity of current span */ 

register SHORT x_end = x_size - 1; /* last pixel on row */ 

move ( (SHORT) 0, y) ; /* start drawing at left */ 

set_pen( intensity = *frame) ; 
for (x = 1; x <= x_end; ++x) 

if (*++ frame != intensity) { 

draw(x, y) ; /* draw one too far */ 

set_pen(intensity = *frame) ; 

) 



} 



draw(x_end, y) ; 



/* 

* update active list 
V 

static edge *update_list(p) 
register edge *p; 

( 

register edge *next; /* edge being examined */ 

register SHORT x_sign; /* registers to speed things up . . */ 

register SHORT x_base; 
register long zx; 

while (next = p->next) 

if (— (next->len) < 0) { /* line is negative length */ 

p->next = next->next; /* chain over it . . */ 

free((char *) next); /* and free its memory */ 



} 

else { 



) 

return p; 



if ( (next->x_frac — next->x_add) < 0) { ' 

x_sign = next->x_sign; /* use registers! */ 
x_base = next->x_base; 
zx = (x_sign > 0) ? next->zx : -next->zx; 
do ( 

next->x += x_sign; 
next->z += zx; 
} while ((next->x_frac += x_base) < 0) ; 

) 

next->z 4<= next->zy; 
p = next; 





III "tlllS chapter we'll be discussing how to render com- 
plex three-dimensional objects. The cube program allowed us 
to focus on the fundamental, mathematical issues of three- 
dimensional perspective: matrix transforms and parallel and 
perspective rendering. In this chapter we'll be focusing more 
on the techniques of displaying an image. 



Hidden-Surface Routines 

There are many ways to handle the general-case problem of 
removing hidden surfaces. With the cube in the last chapter, it 
was possible to derive a simple algorithm to determine which 
face was visible; the general case is much more difficult. In 
this chapter, we'll discuss one of the simplest techniques, the 
so-called z-buffer algorithm. 

There are two major questions to be considered for hidden- 
surface elimination routines: which polygons (and what parts 
of each) to display on the screen, and how to shade the poly- 
gons. We'll be using the simplest possible methods to accom- 
plish both of these goals, but the work is still not trivial. 

Illumination Models 

Let's begin by tackling the question of how to illuminate a 
given polygon. In cube it was easy; we were using color, and 
assuming that the cube was being lit from all sides. In the 
more typical case, however, there is a light source (possibly 
more than one) illuminating the various polygons. 

Light interacts with surfaces in widely varying ways. 
Some surfaces absorb all light: "black bodies." Some reflect 
different amounts of light at different frequencies, making 
them appear various colors. Some reflect light very precisely, 
like mirrors, while other surfaces, like wood, reflect incident 
light randomly, making them appear uniformly illuminated. 

There are two fundamental kinds of reflected light: the 
diffuse reflection, and the specular reflection. Diffuse reflection 
is the ordinary lighting that an object has when it's in the 

253 



Chapter 11 



*/ 

point_tnnsf orm ( v , result, m) 
register vector v; 
vector rssult; 
register transform m; 

sector temp; 

tenprx] = v[X]*m[0][X] + v[Y]*m[l] [X] + v[Z]*m[2] [X] + v[H]*m[3] [X] ; 

temp[Y] = v[X]*m[0][Y] + v[Y]*m[l] [Y] + v[Z]*m[2] [Y] + v[H]*m[3] [Y] ; 

temprZl = v[X]*m[0][Z] + v[Y]*m[l] [Z] + v[Z]*m[2] [Z] + v[H]*m[3] [Z] ; 

temp[H] = v[X]*m[0][H] + v[Y]*m[l][H] + v[Z]*m[2][H] + v[H]*m[3] [H] ; 
result[X] = temp[X] ; 
resultfY] = temp[Y] ; 
resultfZ] = temp[Z); 
result [H] = temp[H] ; 



/* 

* rotate_transform() is called from main.c to provide a rotation 

* matrix for rotate_cop() . The passed matrix is zeroed, then 

* cos and sin values are appropriately inserted according to the 

* valu* of d (dimension) , which can be X, Y, or Z. 
*/ 

rotate_transform(d, theta, m) 
register SHORT d; 
register FLOAT theta; 
register transform m; 

{ 

register SHORT l, "j; 

for (i = 3; i >= 0; i— ) for (j = 3; j >= 0; j— ) m[i][j] = 0; 
m[0][0] = m[l][l] = m[2][2] = 0.0 + cos (theta) ; /* Megamax bug!! */ 
m[d][d] = m[3][3] = 1; 

switch (d) { /* Megamax bug */ 

case X: m[2][l] = ZERO - (m[l][2] = sin (theta) ) ; break; 
case Y: m[0][2] = ZERO - (m[2][0] = sin(theta) ) ; break; 
case Z: m[l][0] = ZERO - (m[0][l] = sin(theta)); break; 

) 

> 

/* 

* matrix_multiply() multiplies a and b, leaving the result in "result". 
V 

matrix_nultiply(a, b, result) 
register transform a, b, result; 
< 

register SHORT i, "j; 

for (i = 0; i <= 3; i-H-) for (j = 0; j <= 3; j++) 

result[i][j] = a[i] [0]*b[0] [j] + a[i] [l]*b[l][j] + 
a[i][2]*b[2][j] + a[i][3]*b[3][j]; 

> 

Program 11-7. sphere.c 

/* 

* procram to generate a zbuf data file which looks like a good sphere 
*/ 

# include <stdio.h> 

extern double sin(), cos(), sgrt(); 



The z-buffer Algorithm 



extern int atoi ( ) i 

FILE *outfile; 

main(argc, argv) 
int argc; 
char *argv[] ; 
{ 



) 



float theta, alpha, th_step, al_step; 
int i, j, res; 

if (argc != 2) ( 

fprintf (stderr, "usage: sphere <number of polygons>\n") ; 
exit(l) ; 

) 

res = atoi(argv[lJ) ; 
if (res < 8) ( 

fprintf (stderr, "too few polygons, must be at least 8.\n") ; 
exit(l) ; 

) 

res = (int) sqrt( (double) res) ; 

if ((outfile = fopen("nsphere", "w")) = NULL) ( 

fprintf (stderr, "Couldn't open nsphere as output file\n") ; 

exit(l) ; • 

} 

th_step = 6.283 / res; 
al_step = 3.1415 / res; 

for ( i = 0, theta = 0.0; i < res; i++, theta += th_step ) ( 
fprintf (outfile, "3\tl\n"); 
point (0 . 0 , theta) ; 
point (al_step, theta) ; 
point(al_step, theta + th_step) ; 

for ( j = 1, alpha = al_step; j < (res - 1); alpha al_step ) 

f or ( i = 0, theta = 0.0; i < res; theta 4= th_step ) ( 

fprintf (outfile, "4\tl\n") ; 

point (alpha, theta) ; 

point(alpha + al_step, theta) ; 

point (alpha + al_step, theta + th_step) ; 

point(alpha, theta + th_step) ; 

for ( i = 0, theta = 0.0; i < res; i++, theta 4= th_step ) { 
fprintf (outfile, "3\tl\n") ; 
point(alpha, theta) ; 
point(alpha, theta + th_step) ; 
point (alpha + al_step, theta) ; 

) 

f close (outfile) ; 



point (al, th) 
float al, th; 

fprintf (outfile, "% . 4f\t% . 4f\t%. 4f\n" , 
(float) (cos(th)*sin(al)) , 
(float) cos(al), 
(float) (sin(th)*sin(al))) ; 
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Srealtove(rp2, (long) x, (long) y) ; 

) 

'* 

* area_cbaw() to another vertex of the same polygon. 
*/ 

area_drawix, y) 
SHORT x, y, 

jceaDraw(rp2, (long) x, (long) y) ; 

} 

'** area eed() performs the AreaEnd() call to close off the last polygon, 

* then~~d_splays the previously inactive, just-created picture by using 

* the Intuition ScreenToFront() call to bring it onto the display. 
*/ 

areaendC 

' ragister struct Screen *s; 

register struct FastPort *r; 

SstAPen(rp2, (long) lastjLntensity) ; 
AreaEnd(rp2) ; 

SstAPen(rp2, (long) intensity); 
if (screen2) { 

s = screen2; screen2 = screen; screen = s; 

r » rp2; rp2 = rp; rp « r; 

ScreenToFront(s) ; 

) 

cone = 1; 

i 

* Our opiated exit_graphics() function frees the extra memory needed 

* for AieaFill (with FreeRaster) and closes the extra screen. 
V 

void exit_graphics(s) 
char *s; 

( 

jegister char c; 

\BenchToFront() ; 

if (s) printf("%s\n", s) ; 

jrintf ("Hit RETURN to exit from program (Amiga-M to see picture) — j , 

ihile ((c = getcharO) != '\n' && c != EOF); 

if (rp->TmpRas) . 

FreeRaster (rp->TmpRas->RasPtr, (long) x_size, (long) y_size) , 

if (screen2) CloseScreen(screen2) ; 

:f (screen) CLoseScreen (screen) ; 

.f (GfxBase) CloseLibrary(GfxBase) ; 

.f (IrrtuitionBase) clo6eIibrary(lntuitionBase) ; 
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Program 10-8. stpoly.c 

/* 

* The stpoly.c module handles the Atari's area-fill routines with the 

* built-in v_fillarea() routine. 
V 



physscr; 



# include <osbind.h> 
# include <stdio.h> 
§ include "machine. h" 

/* public variables */ 

extern SHORT real_intensity, handle, 

extern long graphscr; 

/* local variables */ 
static SHORT pxyarray[256] ; 
static SHORT pxyptr = 0; 
static SHORT last_intensity = -1; 
static char *map = NULL; 
static long newgraph; 



/* array of vertices for polygon */ 

/* pointer into the array */ 

/* intensity when area_move() called */ 

/* pointer to new memory */ 

/* the other graphics screen */ 



/* 

* When area__move() is called for the first time, last_intensity is -1. We 

* take advantage of this fact to initialize the fill style and create a 

* block of memory we can use as an alternate screen. If a polygon is 

* currently open, we close it; otherwise we assume that we're beginning 

* to draw on the screen and clear it. 
V 

area_move(x, y) 
SHORT x,y; 
( 

register long t; 

if (last_intensity = -1) ( 

vsf_color (handle, 1) ; /* initialize fill style */ 

vsf_interior (handle, 2) ; 
vsf_perimeter (handle, 0) ; 

if (map = malloc(65535)) /* try to get another screen */ 

newgraph = ((unsigned long) map & "(0x7fffL)) + 32768L; 

else { /* not enough memory to doublebuf fer */ 

newgraph = graphscr; 

} 

) 

if (pxyptr - 0) ( 

t = graphscr; /* clear and initialize */ 

graphscr = newgraph; 
clear () ; 
graphscr = t; 

) 

else l_area_end() ; /* close any open polygons */ 

last_intensity = real_intensity; 
area_draw(x, y) ; 

> 

/* 

* area_draw() just adds x and y to the pxyarray table. 

V 

area_draw(x, y) 
SHORT x, y; 
( 

pxyarray[pxyptr++] = x; 
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^intensity - poly_intensity; /* store .oXygon-s^if ic s^ff . • • V 
rew->id = current_id; 

if (ol d_delta - ( /; ^*£2 g.* | 

S^SS?- 0) < * it's heading ^aa^^rt V 

++ay; « — ^_ >x add- /* and fix up x-pos */ 
new->x_frac — new->x_aaa, / 

while (new->x_frac < 0) { 

new->x 4= new->x_sign; 

new->x_frac -k= new->x_base; 

} 

) 

Lw->next - line [ay] ; /* — « - ^ V 

line[ay] = new; 

} 

1 cO-U-w-O is caned to cl^ the poXy^. 
t tSTS^S^ was 'passed eve, so «e couM 

* get m initial value for delta_y) . 
*/ 

static void close_polygon() 

, . /* draw back to start */ 

area draw(init.x, imt.y) ; ^ draw to edgel V 

if (init.x != edgel^x I ^'"f* 1 - 3 " ' if necessary V 
area_draw(edgel.x, edgel.y) . / 

area_draw(edge2.x, edge2.y) ; 



) 

/* 



t are^O updates thrive ^^^^1^^ 
I S^S&TfiS « S^S SSTli-' x-coordinates are updated. 



V 

void area_end() 

( 



/* dummy node base of active list V 
edge active; ' po ^ aet to end of active list */ 

register edge *Xast, / scanline number V 

register SHORT y; / ^^pUer know about subfuncs */ 

static edge *update_list() ; / i;^Jfr. v 
Satlc void sort_list() , write_scanline() . 

if (poly_stat = 1) close_polygon() ; 

5^-fSc^ive; /* Pointer to the end of the active list V • 

for (y = o; y < y_ 8lz ?{ . { /* add line[y] to list */ 

last->next = lme[yj - > reinitialize line[y] */ 

line[y] - 0; /* sort the list V 

sort_llst(S,active) / ^ scanline V 

writi_scanline(active^ext, y) - / ^E"^ the list V 
last = update_list(&active) , / 



/ 



• sort active list into x-sorted pairs of sane-id edges 
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*/ 

static void sort_list(base) 
register edge *base; 

register SHORT id = ■ 
register SHORT x; 
register edge *p; 
register edge *next; 
register edge *min; 



■1; /* current polygon id, or -1 for none 

/* x-pos ition of leftmost edge encountered 
/* scan pointer into list to be sorted 
/* pointer to structure after p 
/* pointer to leftmost edge so far 



V 
V 
V 
V 

*/ 



whiXe (base->next) { 

x m ox7fff ; /* the largest possible value */ 
for (p = min = base; next = p->next; p = next) 

if ((id — -1 || next->id = id) && (next->x <= x)) { 
min = p; 
x = next->x; 

) 

p = min->next; 
if (base != min) ( 

min->next = min->next->next; 

p->next = base->next; 

base->next = p; 

id = (id = -1) ? p->id : -1; 
base = base->next; 

if (id != -1) punt("sort_list: orphaned edge") ; 



/* chain across */ 
/* chain in forward */ 
/* .. and backwards */ 



/* toggle id 



V 



* display scan line 
*/ 

static void write_scanline(p, y) 
register edge *p; 
register SHORT y; 



{ 



set_pen( (SHORT) BLACK) ; 
move ((SHORT) 0, y) ; 
draw(x_size - X, y) ; 
while (p) { 

set_pen(p->intensity) ; 

move(p->x, y) ; 

p = p->next; 

draw(p->x, y) ; 

p = p->next; 

) 



/* black out line */ 

/* draw in polygon scanlines 

/* set new intensity 

/* move to start of scaniine 

/* . . and draw to end of scanline 

/* advance edge pointer 



V 
V 
V 
V 



* update the current scan line 
V 

static edge *update_list(p) 
register edge *p; 

{ 

register edge *next; 
whiie (next = p->next) 

if (— (next->len) < 0) { 

p->next = next->next; 
free (next) ; 



else ( 



next->x_frac — next->x_add; 



245 



ft V 



tMSl SpSI < 



We've gotten this far without worrying about 

what to do when lines go off the screen. In polygon.c, we re- 
jected lines that went off the screen initially. In zbuf, we al- 
ways made sure that the screen was big enough to hold the 
entire picture. However, it's not always desirable to scale the 
image down until it fits on the screen. In cube.c we observed 
that if you got close enough to the cube, the lines drawn on 
the screen would extend off it; on the Amiga this sort of be- 
havior usually results in a crash. 

How, then, can we avoid drawing lines off the screen? 
This, and other related topics, is an important question in 
computer graphics. Keeping the lines on the screen — clipping 
them so that they fit— is crucial for all drawing applications. 
Some computers take care of clipping for you; the Amiga will 
do this if you use windows rather than screens for the display. 
However, even when the computer can do the operation, it's 
usually better to do it ourselves, since it gives a greater degree 
of control. It's also necessary, sometimes, to clip the image in 
ways in which the computer can't operate. 

Two-Dimensional Clipping 

The simplest form of clipping is clipping points so that they 
fall on the screen. The problem is a simple one, and is easily 
solved. Let's say we have a point (x,y) that we want to plot on 
the screen, and the size of the screen is (x_size, y_size). To 
determine if the point is on the screen, all we have to do is 
m?ke sure that all the following tests are true: 

x < x_size 

x >= 0 

y < y_size 

V >*= 0 

If so, the point is on the screen, and we can plot it. Let's write 
a "front end" to the plot( ) routine in machine. c, which 
checks these conditions for us: 
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w[Y] - v[Y] ; 
w[ZT - v[Z]; 
w[H1 = v[H] ; 

) 

scalejxwj.ectorCv, w, s) /* copy vector v to w, scaling by s */ 
register vector v,w; 
register FLOAT s; 

w[X] = v[X] * s; 
w[Y) = v[Y] * s; 
w[Z' ■= v[Z] * s; 
w[H) = v[H] ; 
} 

divide_vect3r(v, a) /* «1» vector v dcwn by a */ 

register vertor v; 
register FI3AT a; 

' if (a = 0) punt(»divide_vector: attempt to divide by zero") ; 

else { 

v[X] /= a; 
v[Y] /= a; 
v[Z] /= a; 
v[H] « 1; 

) 

) 

subtract_v«ctor(v, w, result) /* set result to v - w */ 
register vector v, w, result; 

result[X] = v[X] - w[X] ; 
result[Y] - v[Y] - w[Y] ; 
result[Z] = v[Z] - w[Z] ; 
result [H] = U 

) 

/* Note: tois routine is typically where the Lattice float bug shews up 
FLC^gritarie(v) /* return magnitude of vector v */ 

register vector v; 

' return (FLOAT) sgrt(v[X]*v[X] + v[Y]*v[Y] + v[Z]*v[Z]) ; 

) 

FLOAT dot_proauct(v, w) /* return dot product of v and w */ 
register vector v, w; 

' return v[X]*w[X] + v[Y]*w[Y] + v[Zj*w[Z]; 

) 

cross_proiuct(v, w, result) /* set result to cross product of v and w */ 
register vector v, w, result; 

resultfX] = v[Y]*w[Z] - v[Z]*w[Y]; 

result[Y] = v[Z]*w[X] -v[X]*w[Z]; 

result[Z] =v[X]*w[Y] -v[Y]*w[X]; 
result[H] = l; 

} 
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MATRIX OPERATIONS 



* the point transformO routine takes v and in (a vector and a 

* transformation matrix) and sets result to the result of toeir 

* product. Note that temp is used internally so we can have v - result. 

* To improve speed, no looping is done. 
*/ 

point_transform(v, result, m) 
register vector v; 
vector result; 
register transform m; 

{ 

y^f^^'vrYl^rOHXI + vm*mri][X] + v[Z]*m[2] [X] + v[H]*m[3] [X] 
S3 - v SSo Yl + v Y ]Z 1 Y + V Z *m 2 [Y] + v[H]*m[3] [V] 
- 2 + v Y ]Z i Z + v Z *m 2][Z] + v[H]*m[3][Z] 

result[X] = temp[X] ; 
result[Y] = temp[Y]; 
result [Z] = temp[Z]; 
result [H] = temptH] ; 

) 

7 * rotate transform() is called from main.c to provides rotation 

* Stridor rotate ccp() . Tne passed matrix is zeroed^ then 

* cos and sin valued are appropriately inserted according to the 

* value of d (dimension) , which can be X, Y, or Z. 
V 

rotate_transform(d, theta, m) 
register SHORT d; 
register FLOAT theta; 
register transform m; 

register SHORT i, j; 

for (i = 3; i >- 0; i-) for (j = 3; j >= 0; j-) m[i][j] = 0; 
S][0] -mt2][2] = 0.0 + cos(theta) ! /* Megamax bugM */ 

m[d][d] = m[3][3] =1; 
switch fd) { /* Megamax bug */ 

^ ( Sise X: m[2][l] = ZERO - (m[l][2] = sinftheta ; breaX; 

case Y: m 0 2 = ZERO - (m[2] [0] = sin(theta) ) ; break; 
Sst i: m[l][0] = ZERO - W 0][l] = sin(theta)); break; 

) 

) 

7 * matrix_multiply() multiplies a and b, leaving the result in "result". 
*/ 

matrix_multiply(a, b, result) 
register transform a, b, result; 

( 

register SHORT l, j; - 
for (i = 0; i <= 3; i++) for (3=0;: <= 3; }++) 

result[i][j] = a[i] [0]*b[0] [j] + a[i] [l]*b[l] [Jl + 
a[i][2]*b[2][j] + a[i][3]*b[3][j]; 
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4. Calculate the intersections and plot whatever is visible. 

Now that we've eliminated some lines by drawing them, 
and some lines by throwing them away, we still have some 
lines whose intersections with the window must be calculated. 
Some lines may have one endpoint in the window and the other 
outside of it; then the line must be clipped and only the visi- 
ble portion of it drawn. Some lines, even though they pass the 
test above, aren't displayed at all, like line Q in Figure 12-1. 



Figure 12-1. Lines to be Displayed 




The obvious method to calculate the intersections of the 
remaining lines with the edges of the windows is to calculate 
the intersections of the line with the lines that make up the 
borders of the window. Some of these intersections may lie 
outside the window itself; consider the intersections of line Q 
with the lines that make up the window border (see Figure 12- 
2). 

When an intersection of the line and a window borderline lies 
within the window itself, we use that as the new endpoint of 
the line. 

However, this process is difficult and time-consuming. 
Calculating the intersections with the various window border- 
lines is difficult, since we have to solve parallel equations to 
calculate the slope and take special care of vertical lines. This 
is a difficult process, and, as it turns out, an unnecessarily dif- 
ficult one. The Cohen-Sutherland algorithm provides a simpler 
method of determining intersection. 




Figure 12-2. Line Intersecting Window 




Essentially, we clip the line successively against each border- 
line, as necessary, using the code computed in step 1 to figure 
out which sides we need to clip against. 

For example, we can begin with the left side of the win- 
dow. For the moment, let's consider endpoint 1 only. If bit 0 
of the code is set, we know the endpoint is outside the win- 
dow. So, we have to figure out where it intersects the left edge 
of the window. Let's assume for the moment that our line runs 
from {xl,yl) to (x2,y2), and that the left edge of the window is 
at x = 0. Then, we have to calculate the y-intercept of our line 
at x = 0. Remember, the formula for a line can be expressed 
in two ways: 

y = yl + slope * (* — xl) 
x = xl + 1/slope * (y - yl) 

where slope = rise/run = (y2 - yl)/(*2 - xl). 

To calculate the intersect of the line with x = (J, then, we 
have to calculate a new value for yl. To do this, we plug in 0 
for x in the equation for y above. The result is the new value 
of yl, and the new value for xl is 0. The equation we use to 
arrive at the new value for yl is thus 

yl + (y2 - yl)/(x2 - xl) * (0 - xl) 

We now have a new value for (xl,yl). The new line seg- 
ment from (xl,yl) to (x2,y2) is not guaranteed to be visible; all 
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upd£bejviewpoint( scale) ; 

) 

7 * update viewpoint () applies the given transform to OOP, VKP, 

* VPN and WP, then updates the display via display_update ( ) . 

* If we tri to rotate or scale into the cube, it's rejected. 

*/ 

int update viewpoint (m) 

transform m 

{ 

vector new_cop; 

poiit transform(cop, newcop, m) ; 

if hew cop[X] <= 1 && new_cop[X] >= -1 && new_cop[Y] <= 1 

S& new_cop[Y] >= -1 " nev_cop[Z] <= 1 && new_ccp[Z] >= -1) { 
printf ("can't move within cube\n") ; 
return 1; 

) 

ccp[X] = new_ccp[X]; cop[Y] = new_cop[Y]; cop[Z] = new_ccp[Z]; 

point_transform(vrp, vrp, m) ; 

point_transform(vpn, vpn, m) ; 

point_transform(vup, vi^j, m) ; 

display_update() ; 

return 0; 

) 

) 

Program 10-3. display.c 

7 * -mis pactage handles the cube's high-level graphics interactions 
* with the screen. 
V 

#include "mchine.h" 
#include "fcise.h" 

static vector cube[8] = { /* define our cube */ 
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)! 

static veclor points[8] ; 
/* 

* display update () calls perspective_transform() to get the 

* key transform matrix, multiplies it with the device driver 

* matrix screen t, applies the transform to the cube of the cube, 

* then calls redraw_display ( ) to invoke the proper drawing routine. 
V 

displayjupdate ( ) 

{ 

transform m; 
register SHORT i; 
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#if IATTICE 

FIDAT delta; 

#endif 

natrixjnultiply(getj3erspertive_transform() , screen_t, m) ; 
#if IATTICE 

/* check the matrix's internal consistency: we know mathematically 

that the value of m[3][3] must be 1 / (1 - persp) . */ 
delta = 1 / (1 - persp) ; 
delta = (delta - m[3)[3]) / delta; 
if (delta > .01 If delta < -.01) 

punt("Iattice float bug has manifested., data corrupted") ; 

#endif 



for (i = 0; i < 8; i++) { 

poirit_transform(cube[i] , points[i], 
normalize(points[i]) ; 

) 

redraw_display() ; 



m) ; 



* redraw_display() calls either draw_f illed_cube ( ) or draw_outline_cube ( ) 

* to actually render the image. 
*/ 

redraw_display ( ) 



switch (fill) { 

case 1: draw_outline_cube ( ) ,- break 
case 2: draw_filled_cube(0) ; break 
case 3: draw_filled_cube(l) ; break 

) 



/* 

* draw_outline_cube() draws the edges of the cube. 
V 

draw_outlrne_cube ( ) 

{ 



clear() ; 

set_pen( (SHORT) WHITE) ; 
move( (SHORT) points[0][X] 
draw( (SHORT) points[l][X) 
draw( (SHORT) points[2][X] 
draw( (SHORT) points[3][X] 
draw( (SHORT) points[0][X] 
draw( (SHORT) points[4][X] 
draw( (SHORT) points [5] [X] 
draw( (SHORT) points[6][X] 
draw( (SHORT) points [7 ] [X] 
draw( (SHORT) points[4](X] 
move ( (SHORT) points[l)[X] 
draw( (SHORT) points[5][X] 
move( (SHORT) points[2][X] 
draw ((SHORT) points[6][X] 
move ( (SHORT) points[3][X] 
draw( (SHORT) points [7 ][X] 



(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 
(SHORT) 



points[0] [Y]) 
points[l][YJ) 
points[2][Y]) 
points[3][Y]) 
points[0][Y]) 
points[4][Y]) 
points [5] [Y]) 
points[6][Y)) 
points [7 ][Y]) 
points [4 ][Y]) 
points[l][Y]) 
points[5][Y]) 
points[2)[Y]) 
points [6] [Y]) 
points[3][Y]) 
points[7][Y]) 



* draw_f illed_cube ( ) checks to see which faces are visible 

* by noting the position of the OOP. If we are more than 1 



away 
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•xaaiaA pua am pus uoipasia;ui aq; 
qioq ;nd;no o; paau 3m 'uaa.os aq; o;uo Suiuioo si auq 
aqi uaqM 'laAaMOj-j -uoipasia^ui sq; ;nd;no si op o; paau aM 
ip os ';nd;no uaaq ApESflB SBq (auq aq} jo SuiuuiSsq sq; ;e) 
xa^aA ;siij s;i mou>i 3m 'uaaios aq; //o SuioS si auq aq; uaqM 
j|ss;i xaVaA aq; ;nd;no o; aABq aM puv 'uaaias aq; q;iM aSpa 
sq; jo uoqoasia;ui sq; ;nd;no o; 3Aeq sm 'uaaios aq; o;uo >pBq 
Suiuiod si aSpa uoSAjpd aq; uaqM Mau„ aq; sb a§pa 

u33:os aq; pus aSpa uoSAjpd aq; jo uoipasja;ui aq; ;nd;no aM 
os 'ussios sq; SuiAEaj si aSps uoSAjpd aq; aisqM ;qSu xs;j3a 

S }uiod }nd|no 
uoipa8J3;ui jndino »nd}no ou 

U33I38 8UII3»U3 aWiSIAUt ^3.111113 

a 38pa D a8 P 3 
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uotp3SJ3)ui ]nd]no 

U33J3S 9uiAE3] 




z 



1 }uiod indjno 
ajqisiA X{3Ji)U3 
V sSps 




Z 



•9-31 ajitfij 



ooe 



b 3ABq pjnoqs uoSAjpd paddip 'Mau 3q; 'ussids aq; jjo Sui 
-pBaq si sSps aq; fl -Suiddip auios op o; aABq 3av 'uaaios aq; 
SuiAeaj jo Suua;ua si sSps uoSAjpd sq; uaqM 'jaAaMOjq 

•xa;aaA ;xau aq; o; uo 3aoui puB 'Suiq;AuB op ;,uop 3m 
;Ases osje si uiaj.qo.id jtio 'uasios aq; jjo Ajsiqus si aSpa uo§ 
-Apd aq; fl 'asiM3>in auo ;xau sq; o; pasooid puB uo Sui;;is 
3I,sm xs;j3a sq; ;nd;no si op o; 3ABq 3M [tb .'ayduns si uiapoad 
.mo 'usaiDS aq; uo Ajsiqua si aSps uoSAjpd 3q; usqM 
•sSps uoSApd 3q; JO „pus„ sq; yt 3J,3m ;Bq; subsui qoiqM 
'xauaA snoiAaid 3q; puB xs;jsa ;u3Jiud sq; ;b Suppo!. sAbmjb 
si suunoi 3qi -g-Zl aJnSy ui UMoqs aiE sssbd moj sqx "pus 
o; SuiuuxSaq uioij uoSAtocI 3q; punoiB Suiaoui sj.sm ssnBD3q 
^uoipsiip,, b SBq 3§pa qoBa ;Bq; i3quiauiai 'a PUB g S3SBD joj 

•usajos 3q; Suus;u3 si 3§p3 uoSApd sqx q 
•ussjos 3q; jjo Xpjpua st aSps uoSXpd aqj, j 
•ussjds sq; Suiabs^ si s§ps uoSAjpd sqx 'a 
'ussiDs sq; uo Xianjua si 3§ps uoSApd sqx 'V 

:dip o; SuiAj; sj,3m ;Bq; s§ps uoSXpd Xjsas joj sssbd 
jnoj aiB 3isqx 'suou ssuiqsuios 'om; ssuiqsuios 'ssuiuibxs 
;i xs;isa Aj3as ioj xs;jsa 3UO ssuiqsuios :saDi;jaA Mau jo ;sq 
b s;nd;no ;t sum aunnoi sq; sy ';suibSb paddip Supq si uoS 
-Ji\od sq; ;Bq; sSp3 sq; puB 'xs;j3a snoiASid sq; 'xs;jsa ;usxino 
sq; jo diqsuoi;BT3i sq; sauiuiBxa auqnoi aq; da;s qDBS ;y 'Suiu 
-uiSsq sq; ;b ypvq s,}? n;un uoSXpd sq; punoJB sssssiSojd puB 
xs;jsa ;sjij sq; q;iM s;jb;s sui;iioj sq; 'uoSXpd sq; dip ox 

•(piuiBiAd 

b 10 sqrtD b a>ffl 'uoxyd\{fi\od xdauoo b o;ui uoSXiod puoisuauiip 
-aajq; b Suiddtp) Suiddqo iBuoisuauiip-aaiq; op ostb ubj 
aui;noj aqx 'a>m iqSjui auo sb \\dM. sb suoSAiod 3abduod ;bsi; 
;,usaop 3ui;noj aq; 'aas \\,3M. sb 'jsasmoh -(ussaos iBinSuBpsa 
'b ;sn( ;ou) bsjb Sutddqo xsauod Aub o;ui (sabduoo jo xsauoo) 
uoSArod Aub dip ubd noA rsiqixsTJ Aijibj si uiq;uo§iB siqx 

•USSIDS 

sq; uo psABidsip sq ubd puB 'aSpa AjaAa o; paddip uasq 
SBq uoSAjod sq; 'psqstutj sa^m usqM 'a^P B 1* aS P 3 AiopuV* 
suo Aq uoSApd sq; dip sm '3duo ;b tjb MoputM 3q; o; uoSApd 
sq; dip o; SuiAi; uBq; Jsq;B^ -(psssnosip ApBSflB uiq;uo§iB 
Suiddip-suq puBpaq;ng-uaqo3 sq; 3>rt. qanui) s3Dsid larjeuis 
o;ui UMop ui3[qojd SuiddqD-uoSApd sq; s^Baiq uiq;uo§TB siqx 
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eoe 




suib^uod ostb n 'paddip si mdino aqi qSnolpiV tI aM Aja £ 10U 
'Xwcutmojun iuiaiqojd siq; q«M T_B3p uiqiuoSTB uBuiSpoiq 
-puBTWipns avp saop moh "aAoqe aiduiExa jno a^i 'aoBtd auo 
irem ajoui ux MopuiM sqi p3siaaui ;eip suoSXrpd saeduod in si 
siqa jo siduiBxa snoiAqo isoui am 'sSuitrej sii jo auios *e ^oot. 
' b a>fB} s,}ai 'uivpuoSTB aip passnosip 3AEq aM. ibi# mom 

•uo SuioS 

s }bum puBisaapun noX ams syeva 0} jj qSnoiqi >tooi pue uibjS 
' -oid atduiBS am 0} oS uam ' A W} 4^9 s <^ 83U ? S 'uiW o8 I B 
UBiuSpoH-puBpamns aq} *noqB spnip 0} }uauioui B a>fBi 

•}inoijjip ApiEj si Suiuxpdid ajpuBq 01 apoo 
SupuM ruoiiE}uaui3iduii sibmijos b usq} aJBMpiBq b o; aioui 
paims st poqiaui sap ui Suiuipdid 'aaAaMOH -uiaiqoid auiBS 
aq; aheuussss aJ,Xatp aouis 'saSpa moj avp jo qoBa Suiddip 
jot sauunoj a^BJBdas aABq 01 iubm AnBtipB i,uop aM 'asmoD jo 
•q^ioj os puB 'auunoi dip-pipp. aq; 01 oS uiiq ut santBA initio 
asoqM 'dip puooas aqi saop }Bq} aupnoi aq; 01 dip ;sjij aqj 
uiou santBA indino aqi sssd aM 'Mimpdtd panso s^bum op 
01 aiqissod n sa^Bui siqi 'uoSApd avp jo saorpaA jo aidnoo b 
ajB paws ia8 0} spaau u he »wp asflBW ll n0j{ ' aAOC l E aupnoa 
aq; ;noqB 5piap noA ji -aiu* ;,usi siqi 'WAaMoq 'pbj uj. 

i£-ZX a-mSM 

sSuiddip aiBipauuaiui amduioo aM anqM Aaouiaui ui 'paddip 
Xpjcd 'uoSXfpd apqM b daa>[ 0} paau aM }Bqi uiaas pinoM 
n 'os -a§pa auo ;suieSb sdip atuo auunoj aAoqB aip puB 'paqsj 
' -uij aA aM ajojaq MopuiM b jo saSpa moj [TB }SUibSb uoSAjpd 
b dip 0} 3ABq 3M -aSejois aiBipauuaiux jo \o\ b spaau ji }Bq} si 
paaqou 3ABq aeui hoa jsqi 3upnoi siqi ipiM uiaiqoid suo 

•SAVOpUTM JBpSuBpaJ O^ UOISStlOSip 

siq^ ;iuiq \\xm. ;nq '}Bq; )noqB Xjjom o; SuioS jou aJ,3M TT 3A * 
' sb japaBq auiooaq suoppasja^ux puB (;no ainSij 01 spnpoad 
ssojo Suumbaj ua;jo) unDijjip aioui iBqMauios sauiooaq /( apis 
-;no„ puB ^apisui,, si }BqM Suiuiuusiaa •pai^H^ 03 dlom 
pS sSunp 'u'oSXpd jaq;ouB isutbSb uoSApd b Suiddip di,3M. 
uaqM '3SB3 ibjsusS sq; joj -aupnoi puBpaq^ng-uaqo3 aqi 
joj pip aM Xbm auiBS sq; suopoasja^ui a^BpoiBo ubd aM 

(•Suiqi 3UIBS aq; ssa{ jo aaoui aJB suia^qoad OA\a asaqx) 
•psqsiuij 3A 3M ajojaq xaiJaA isjij aqi oa X31J3A isbi sq; psu 
-uod 01 isquisuiai o; aABq 3m 'Apsnuiis -doot sqa qSnoiq; suip 
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SOE 

cp o; o-aqno ui pasn aM ;Bq; ainpoui o'£\o& sq; sssn q -uieiS 
-aid flij-eare ;sjij sq; jo uoisisa pssiASJ e si 3-3 x uibjSoij 
•3 ui it ;u3Ui3iduii ;,uom 3m ;nq 'uiq;uoS{E dip uo;a3q;v--iaiPM 
aui 'sauqnoi pa;E3qduiOD aaoui am jo auo ssnosip Anauq n,9M 
•;i ;noqB axiom o; sn ioj qSnous uouiuiod ;,uajE suo§A[od 3ab3 
-uod ;nq 'suoSApd sabouod ioj is;;3q >jjom ssuqnoj ps;E:>qd 
-moo aaoiAi -aupnoi siq; Suisn aq \\im. 3m 'A;pqduiis pus paads 
jo ;sa.ia;ui aq; ui 'aaAaMOH 'uaaaos sq; 10 jspjoq aq; punojB 
Suiuuiu 'suoSAjod om} aq; Suipauuoo uaas aq ubd suq b 
'saupnoj [xg-B3JB jno q;iM uaajDsuo umbjp si siq; .a^ij uoSApd 

paddip b ji -sqnsaj 3§ue.i;s auios ppiX ubd uiatqoid siqx 
•piB;sjapun o; punojB uoSAjod paddip aq; jo lapioq aq; Mono*} 
•i^piM 0 jo sSpuq b Aq ;nq 'papauuoD flp s 3I8M suoSApd aq; 
ji sb qonui 'a§pa aq; jo uio;;oq aq; Suo{E ssuq Aq papauuoD 
aiB Xaqx -suoSApd a;BJBdas om; o;ui pa;BJBdas auiooaq SBq 
uoSApd aq; 'dip ;sjij aq; ia;jB uaAa 'jsasmoj-j -MopuiM aq; 
utq;iM Ajsjqus ;i Suuq amSij aq; ;suibSb sdip aAissaoons 

•a§pa qDBa 

H;im xoj ypaxp o; aABq aM qDiqM sasED inoj aq; japisuoD puB 
CnnjaJBD aanpid aq; auiuiExg iSuisnjuoD apq B U183 S 'I 8u P 



s 




-;nd;no snq; puB 'a;noj ua aiqisiA Ajsjqus Suiureuiai '\ o; >pEq 
uoSApd aq; ai; 3av 'Xhbuij "8 ;nd;no aM os 'aSpa uio;;oq aq; 
3AoqB 3{qisiA UIBUI3J 3M 8 o; Suio^ -xa;j3A b puB uotpasis; 
-ui ub ;nd;no aM sisq ;uiod o; ;3§ aM n;un Suiq;AuE ;nd;no 
; ( uop aM 'ajqisiAUi sjcb 9 puB q s;uiod q;oq aauig 'uo oS puB 
(0l"3I wnSig aas) Bg ;uiod ;nd;no aM os 'uibSb aSpa Suiddip 
aq; ssojd 3m <j o; Suio;} 'anuquoD puB f xa;i3A ;nd;no 3M os 
'3§pa Suiddip sq; ujojj aiqisiA si f 0; g uioxf auq aqx "Jias;i £ 

;uiod puv (ot-ZT 9Jn§H U T B Z P 3 ll B:) ) £ °1 2 ^o^J au H 9 M : t W M 
aSps uio;;oq aq; jo uoqD3SJ3;ui sq; ;nd;no 3M os 'bsjb aiqisiA 
aq; o;ui >{DBq ssoio 3m '£ ;utod o; saoui 3m sy 'jps;i 3 ;uiod 
;ou puB (o\-zi a-mSy ui bx ;uiod) uoipasj3;ui 3q; ;nd;no 3m 
subsui siq; .'3AoqB ssjm .mo Xg -u33jds aq; Suiabsj '(aSpa uio; 
-;oq aq;j (/ a§pa Suiddqo,, sq; ssoio 3m z ;uiod o; Suiaojai 

^■syqisiAUi,, p3JBpsp si ;uiod sq; 
s3§b;s j3;b^ 3S3q; §uunp fajaq Suissnosip ai^M Abm auiBS sq; 
ui S3§ps jsddn puB ';q§u ';js{ 3q; ;suibSb psddqa Xp;Bip3uiuii 
si ;uiod siqj, ';i ;nd;no sm os '(;sb3[ ;b 'p3ujsduod si aSps uio; 
-;oq 3q; sb jbj sb) ^sjqisiA,, s^i 'asBD siq; uj aiqisiA s,;! ji Ajuo 
;i ;nd;no puE 'asn ja;B{ joj su^ea s;i sabs sm .'XqBpads ;EqM 
-auios pa;E3« si ;uiod ;sjij sqx "sSps uio;;oq sq; ;suib§b Suid 
-dip 'ssBd Suiddip ;sjij sq; X^uo iiB;sp n, 3 M 'I ;uiod ;b ;jb;s 
sm fAjuBi;iqjB uoSA^od sq; p3[sqBi 3a 7 sm 6-3 1 3inSy uj 

■p3;B3J3 aJB sa§p3 3;BisusS3p sq; Moq 
Moqs o; puB 'SuiddqD UBUiSpoH-puBpaq;ng jo 3|duiBxs ub 
sb q;oq 'sdBqs sabduod a^duiis b jo Suiddip aq; 3dbj; s^aq 




zoe 

[nj3sn /Lisa b aq pjnoM 3.ui;bu siq; jo uupuoSjB Suiddip y 

(•uiqjuoSje 8uiddip-3uq puBpzaq;ng-u3qo;} aq; ;no 
SuunStf uaqM aAoqe pasn 3m suoqenba auies aq; 3je 3ssqx) 

i(r^ - v-) * (ix - ZX)l(iz - zz) + iz = z 
- V-) , (r* - ZX)/(lfi - zH) + in = n 

!y— = ^ 

:Aq uoip3si3;ui aq} jo sajBuipaooo z'H'x aq} aie^riDpj 
UB3 aM. \z 2 'Z^'Z x ) o; (iz'iU'ix) uioij sum auq mo jj - (y_ = x 
;b auefd z/t aq; o; pflBiBd suBjd aq;) susjd „;j3i„ aq; auiuiBxa 
sj3\ 'ajduiBxa io>j - suoisuaunp om; joj uouBnbs aq; azqBjauaS 
Ajduns ubd aM ';utod uop,03SJ3;ui aq; ;no 3in8ij ox - uoipas 
-ia;ux aqi a;nduioD o; paau 3m 'saop ;i aouo uaq;o aq; o; sobj 
s,aqn3 ai[; Aq pauijap auEjd aq; jo apis auo uiojj sao§ ;i ji aas 
pue (aiBudojddB sb) uoSAjod aq; jo a;BuipjooD z 10 'A 'x aq; 
qD;BM UB3 3m .'pjBMJOj;q8iBj;s AptBj si aqria aq; jo apis u3ai2 
b q;iM suoipasia;ui joj qo;EM ox 'aziiBiauaS o; Asb3 si Suiddqj 
{Bjaua§ aiojAj '(v — /+ 'V — /+ 'V — / + ) J 6 saopiaA q;iM aqno 
b o;ur suoSXjod mo dip o; ;ubm aM ;Bq; auinssB s^aq 

•sauBjd aq; 

q;iM saSpa uoSApd jo suoipasja;ui aq; Suunduioo AnEnpB ui 
saq X}jiQijjTp A\uo aqx iBouuapi A"nBi;u3ss3 si anbtuqaa; aqx 
•ajSuBpai b dn a^Biu ;Bq; ssuBjd xis aq; jo qosa ;suib2e ;i dqo 
aM 'saSps inoj s^ssids sq; jo qosa ;suibSe uo§A"[od aq; §uid 
-dip ueq; J3q;e^[ -3jqno.i; qamu oo; ;noq;iM suoisusunp 33jq; 
o; pstqBJ3U3§ aq ubd uiq;uoS{E uEiu8poH-puEp:3q;ng sqx 
Suiddip uoSA^oj iBuoisnauiiQ-aajxix 

"3uop si 3ui;iioj sq; 

puB ';ni;no uaaq 3ABq suoSAjod 3q; \[e 'psMonpj uaaq 3ABq 
saSpa aqi [JB uaqM 'mojjoj o; saSps 3joui ioj s^ooj ;t uoSAjod 
suo s9;atduioD ;i uaqM puB 'pasiaAEi; XpB3j|B ssq ;t saSpa 
aq; siaqui3ui3i X^duiis uiq;uo§{B uo;jaq;v--iaii3M a m 'suoS 
-A\od jbj3A3s ;nd;no o; SBq suqnoi sq; (aAoqB passnostp sauo 
aq; a^ij suoSXpd babduoo) ssdBqs suios ioj 'jsasmoh -uoSAjod 
b paddip s^i ';uiod SuqjB;s 3q; o; >pBq s;3§ ;i uaqyv\ 'pBa;s 
-ui uo§A[od iaq;o 3q; Suimohoj 'ujtu ;q§u b s3>jbui 3ui;noa 3q; 
'P3SJ3;ui uoSX[od dip sq; puB uoSXpd p3(qns sq; 3iui; AiaAg 
■uoipaiip asiM^aop b ui Suipsaq 'uoSXpd dip aq; Suua;ua 
uop3asJ5;ui ub ;b (psddqD §uiaq auo aq;) uoSAjod patqns aq; 
uo s;ie;s \\ 'punojB saSps Suimojioj Aq s>jjom auqnoj sqx 



yut 

•;i ;u3ui3[duii A^bupb ;ou ;nq '3iaq Xgauq ;i uiB^dxs n,aM 
uoSA[od jo pupi isq;o Xub dip o; (xbauod jo 3abouod) uoS 
-Ajod jo pui>{ Xub mo^b ssop ;nq 'xs^duioa sjoui s,;i 'suoSX^od 
Suiddip o; qDBOiddB piauaS sjoui b S3piA0id uiq;uo§(B siqx 

q;iM o-no9Aiod uiojj ssnj b;bp 3q; jo 3uios Sutuum Ai^ 
' a IU JII" E s^ajD o; 3jns 3q pjnoqs sjssn xs H B W 'uiBjSojd 
dno^iod sq; q;iM pasn aq o; sajij ;duDS aiB g-zi puB 'q-z\ 
'f-Zl suibjSojj "uiBjSojd djio£.ioi sq; dn a>(BUi £-zi puB z~Zl 
suibjSojj -;joqB jum uiBiSoid aq; jo 3§ubj 000 1~0 U T ac l 
o; SBq \\])s X;isu3;ui ;Bq; s;om -ussios 3q; o;uo uisq; dip A\d 
-uiis aM 'uasios 000 1~0 e °1 suoSXpd aq; ajBDS usq; iaq;BJ ;nq 
o-tro^iod joj sauo aq; sb ;buijoj auiBS 3q; ur snj b;bp b ui 
spBai uiBiSoid aqx a>tn ^Ml P^b pubuiuiod C )©aoto— sure sq; 
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d H3 » SJ IJ j a»JV noa/Cioj Qi-zi ait&ld 



out 



ssutj uwop-apTsdn asaaAaa */ 



) (iCeHsp) jt 



A Tfxa pus • • */ 

A Bbxj ws~Aiod aouBAps ■ • */ 

A • • SqUTOdpUa aqq 3AES */ .'Ae 

A a£pa qsarj aoj quauriBaaq. XEToads */ 

A saurx zjaoq-uou aoj A~BqxaP qas */ 
A ssuti xmuozfaoq aiou6t */ 



A 

A 
A 
A 

A 



;uoTq.Tsod wau am sabs */ 



.'uanqaa 
'.% = }Bqs~Axod 
;Aq = A-£a6p3 .'xq = x-zafipe 

A-xafipa .'xb = x-xafipa 

} (o = y&a Axod) it 

.' (Aq < Ae) = A~eq.T3p 
.'uanqaa (Aq = Ae) jt 
;Aq = A -sod 
ixq = x-sod 



( 



A~cn3p jo anTEA Pio 3abs */ .'A"~BqTap = miap pio iHOHS aaqsT&aa 
ds«s oq sn wdtte oq sxqBTaBA */ <<tej l&OHS aaqsrfiaa 

aurx jo fiuruurfiaq */ .'A-sod = Ab 'x-sod = xb xaOHS aaqsT&aa 
paqsaao fiuraq afipa oq aaqurod */ .'«au* afipa aaqsrfiaa 

I asia '0 < (AB-Aq) }i 0 */ -0 = A~Bq.Tap IHOHS OTqEqs 



.'Aq 'xq jaDHS aaqsrfiaa 
(Aq 'xq)«Ejp BaxE proA 
A 



•aurj aqq jo pua ao fiuruurfiaq aqq m™ aaduiBq pus auTTUBOs b Aq qr ¥ 
uaqaoqs'art os jt pus 'aurx snoTAaad aqq sb uorqoaarp afflBS aqq ut_6uto6 ¥ 
s,qr jt ass cq >paq? aw pappB sr qsqq afipa AaaAa aoj uauj, - ABqxap * 
aoj aniBA pttea b sn aATfi oq 'qsrx am oq pappE AxaqBrpauniiT qou pus * 
Aewe paABS sr a£pa qsarj aqq :suoTqo3saaqur xaqaaA qB arooo qBqq * 
suQxqpad aqq ptoab oq auop sr. &rrsBO-TEToads jo qunara UTBqaao e * 
qBqq aqoN -uoTqTsod am aqndioo oq saafiaqur asn squauoduco-x aqx * 
•apoo px aq^ P"E Aqrsuaqur am 'afipa a"} 3° saorqaaA P" 3 * 
aqi oq fiurpaoooB pazTTEHTUT puB pa.ooxxB sr aanqonaqs aqi -qsTX [A]aurx * 
aqBradoaddE am oq aanqonaqs afipa ub spps aurqnoa ()«Bop Baas am * 



A irtoXjaaAO aoj qpqErt */ 
A uofiAxod «au */ 

A xaqaaA babs */ 

'» srq.B}s uofiAxod qasaa */ 
A uo5Axod ^sbx asoxo */ 



;o = px q.uaxnro (o > PT ^uai^ra) jt 
.'pT ^uaioro++ 
iR = A-sod = A-q.pJT 
;x = x-sod = x^vtut 
.'A^TsumuT = A4Tsuaqur_Axod 
^0 = 3ms Axod 
; ()uo5Axod~asoxo (x = ws Axod) jt 

.'A3.TSuaq.UT J2JDHS uaaqxa 



> 

^A'x JUDHS 

(A 'XjaAOOI BSOB pTOA 

A 

• (pT - }uaxaro) paiuasazsoi st Bsq. pT uofiAxod am P^b 'paABS * 
aoE (sod) 'xavaA ^.uaoxra puB (iTur) xac^taA XBT^™! 3U i • (3n ^PT^ * 
m Ouo&Axotfasoxo TD» art os 'uofiAxod e Ewtmeip paqsruTj ^snf * 
aA aw uam '^as sr Axod ji -spuEimiDO ()«sap Eaxs jo_saTaas b * 

jo qsorj am jo buruuT&aq am s^as Axdurrs aur^noa Obacui BaiE am * 



A aaxTduro am aurjapaad */ 
A LD&Axod quacuro am 3° AjTsuaqxrr */ 
/'» wBop uofiAxod jo a^ms q.uaxmo */ 
A suofiAxod joj oaqunoo pT */ 



.' OuofeAxod^asoxo Ptoa oT^sqs 
iA^TSuavrr Axod iffiHS oT^ms 
.'0 = q.Bqs~Axod jjkhs OT^ms 
;pT ^uaixira jhchs ot^b^s 



§mdd}iQ 



out 



A a6pa auiBS jo ^urod-pua »/ .'jafipa xaq_raA OT5B3S 

A a&pa ZTaoq-uou qsx jo ^UTod-ttiB^s ♦/ .'xafipa xa^raA ox^Bqs 

A uofiAxod jo 3urod-qjrms */ -'TFur xa^iaA oi^ms 

A Josaro jo uoT^TSod quaoano */ .'sod xaqoaA ot^b^s 

A safipa Burqjms jo Abxte aurTUBos */ •' [aNTTXWjauTX* afipa ot^ 5 ^ 

A axnpooi Axod am m IBqoxfi saxqBTJBA */ 

.'xa^iaA { 
•'A JHOHS 
•'X JHOHS 
) xa^iaA qonx^s japadit; 

A 

• (paxpuBq AxxBToads aq cq. spaau pus uofiAxod am upriaxm aurr^l ^sxrj * 
am paioufiT sx upTUM) aurx ^sxr j am jo pua puB arruurfiaq am 6ut5{Jeui v 
saoxqoaA owq pus .' (saoTqaaA am TTE aABq a« uaq« uofiAxod am tpauuoo * 
ueo a« os) xa^xaA xbt^tut am jo uoTqrsod am .'nJoairo,, am jo uoTqrsod * 
q.uaxxno am — saoT^iaA XEqoxfi jo ipBj^. daai( 03. pasn aiB saororLr^s xaiiaA * 

*/ 

.'afepa ( 

A uofiAxod s-pm jo aaqmnu pT */ .'pT JHOHS 

A jo aurx b aa , art uofiAxod jo A^tsusjut */ .'A^TSumur JHOHS 

A (sauTjuBOs ut) aurx jo u^fiuax »/ .'uax JMOHS 

A objj x aoj assq fiuTTtos ^jun */ .'asBq_x JHCHS 

A auTT xaxrd uoEa uo aAora art uoTrpBaj ♦/ ;ppB_x JHOHS 

A (aujx jo uoT^oaorp) x- ao x */ .'u6ts_x IHOHS 

A (asEq x/objj x) uot^objj xaxrd */ .'objj x JHOHS 

A uoTq.Tsod x iuaimo */ .'x IHOHS 

A ^stx afipa aAT^OE am uo afipa qxau */ .'qxau* afipa qoruqs 

) afipg qaru^s japadAq. 

A 

• (uofiAxod am jo Aq.Tsumur am pub * 
aaqmnu pT uofiAxod am) uofiAxod am m fiur^Exai mep aiuos pus ; (uax) * 
_ sauTTUEOs ur aurx am jo q^fiuax am fiururmuoo IHCHS b .' (asBq~x pus * 
'ppB x 'u6ts x 'osaj x 'x) sauTTUBos aATssaoons uo aurx am jo uoTq.Tsod-x * 
am a^ndujoo oq. sn rtoxxs qsm saxqETOBA 3atj .'afipa „aATqoB„ qxau am m * 
amurod b suTEquoo aarcpnaqs afipa qoBa -uaaaos am unsp ubos am se * 
suofiAxod am jo saapaoq am jo 2pBaq daax m pasn sr aarcpnaqs afipa uv * 

*/ 

.' ()mmT _ ^afi* aBqo 
..q-aurqDBiu,, apnxourjf 

A 

•AjTsuaqur qoaaaoo am JO sauTTUBos paw>x<3 * 
oqur suofiAxod fiurmojsUEaq jo j(acm Axfin am saxpusq o-Axod * 

*/ 

0'6\od 'Z-Zl uiBaSojji 

•uiEiScud sdiitcIbjS snouas Aug o; 
uopippe TriTjaMod pue Xjessaoau b si Suxddip :oS iouubd pue 
ubd ;uiodMaiA mo/L aiaiiM uo suoipu^sai XjexiiqjB Xub ;,u8jb 
ajavji }eiji si Suiddip jo sSbiubapb aqx 'lapeaj aq; o; aspiaxa 

UB SB }I 9AB3] \\ ,3M 'J8A9MOIT 'Sllil 01 3p03 SuipnpUI X[TB 

-npB ubiii .iaiT}Etf "xx JaidBvo jo uiBiSojd juqz mo oi uoptppB 



/. 

auxx ueds quaxmo auq aqepdn * 



xsqxizod afipa aouBApE */ 

f t auxxusos 30 pua cq ftEJP pcre ■ • */ 
' auxrreos }o v&is cq aAoui */ 

sauxiuBos uofiAxod UT WEip */ 



( 

.'3xau<-d = d 
.' (A 'x<-<3)wejp 
.'■}xau<-d = d 
; (A 'x<-d)3Acwi 
.' (A}xsuaqux<-d)uad~qas 

) (d)_ aiT^i 

.' (A 'I - 32TS X)/«£ip 
i(A '0 (JiK)HS))3AC«I 
.'0DY19 (jHOHSjJuacTqas ^ 

.'A J2KHS .xaqsxfiai 
.'d* afipa jaqsxfiaa 
(A 'd)auxTUBOs _ aTP« PTOA oiqEqs 

A 

auxx ubos Aexdsxp * 
*/ 



A 



{ 



! (..afipa pauBudio :5STI vos.J^und (x- =i PT) 3T 



px arfifioq */ 



.'qxsu<-3snsq 
PT<-<J I (I- = PT) 



A spiEMipeq pre • • */ 
/* pjefuoj ur ireup */ 
/* SSCOOE xreup */ 



A 
A 
A 
A 
A 



aseq 
PT 

( 

.'d = 3X3u<-aseq 

.'qX3U<-3SEq = ^xsu<-d 

.'3xau<-qxau<-upu = 3xau<-uxui 

} (uxui =; 3SBq) JT 

:qxau<-uxui = d 
{ 



:x<-qxau = x 
.'d = uxm 

) ((x => x<-:jrau) 55 (PT — PT<-^3« II T- = PT)) JT 

(:rxau = d :qx<3U<-d = qxau iaseq = arm = d) joj 
/* anxcA axqxssod qsafiiBX auq »/ .'3J3£X0 = x 

) (3X3u<-asEq) 



axxu« 



jej os a6p3 qsouqjax cq aaviTod ♦/ .'uxw* 3& P 9 ^raqsT&aa 
d JtaqjB aonqotuqs oq ;raquxod */ -'3xau» sSP 9 Jaqsxfiai 
paqzos aq cq ^sxx cqux ^raquxod 11,2=13 •/ id * 3&pa -za^ 6 " 

paxaqunoois afipa qsouqjax'jo uoxqxscd-x */ :x jmoHS oaqsx&aa 

auou zoj x- JO 'px uofiAxod quaxjro ¥ / .'x- = PT IHDHS JEqsxfiaj: 



} 



;asEq* afipa jaqsx&aa 
(asEq)^sxx V°s PTO^ OTqB}S 
A 

sa6pa px-aures jo srred paqros-x cqux qsrx aAxqoc ijos * 



/ 



{ 



/* 5SXX stR- aqspdn pub */ 

/» auxxmos auq qncqno */ 

/» ^sxx am Vos */ 

/* [A]auxi azxTBT^WTai */ 

/* ^sxx n [A]auxT PP^ »/ 



.' (aAX30B>s)3STT aqBpdn = ^sbx 
! (A '^xau-aAxqoBjairxxuBOS aq.xa« 

.' (3AX30B>?)3SXT VOS 

;o = [A]aurx 
: [A]auxx = ^xau<-5SBX 



gmddtij 



} (A++ .'azxs A > A io = A) joj 
A ^STT 3ax^ob aia jo pua aiR cq jaquxcd */ .'aAxqoB? =_qssx 

.'0 = 3-Bqs Axod 
; (JuofiAxod-asoxo (X = ^b^s Axod) jx 

.' ()auxTUBOs _ aq.Taft ' ()^sxx _ qJos pxoa oxqBqs 
/♦ sounjqns inoqB «ouk jaxxduiDO ^ax */ •' O^STT aqsparw abpo oxqB^s 
A jaqumu auxTUBOS ^uaxtro ♦/ :A IHQHS Jaqsxfea 

A ^sxx aA-pos jo pua cq ja^uxcd */ .'^SBX* a6pe xaQsxbax 

A 3SXT aAX^OE jo aseq apou Araimp */ .'aAX^os a£pa 

} 

()pua B3LIB PXOA 

A 

•paq.Bpdn aiB saqBuxpaooo-x ,sauxx ayq. ptre 'poAoraai axs in&rax aAX^efeu uqx« * 
sa6pe 'AxxbuxJ *3UTT axR- sAsxdsxp pus ^STT s^jos-ai irauq 'sa6pa » 
auxx ubos 10 Abjjtb []aaxx auq "caj ^STX aAX^OB atq sa^spdn ()pua _ BaiE * 



.'(A-sa6pa 'x-3a6pa)ftEjrp _ BaLrB 
A AiEssaoau jx */ .' (A"xa6pa 'x-xa6pa)«Eap eauB 

A xafipe cq weip Axuo ¥ / (A-xa6pa =; A-^fUT I I x-xa6pa =i x-^xux) jx 
A VB^s cq jpEq MEjp */ .' (A-^xur 'x-q.xux)rtE3p sane 

OuofiAxodTasoxo pxoa oxq.B^ 
' A 

• (A~B3xap JOJ anxEA xbtixux ub ^ab * 
pxnoo an os oaAO passed sen ipxu«) abpa ^sxrj auq «Eop uauq 'quxod ^sxrj * 
auq oq. ipeq 6ux,«Ejp eaie Aq uofiAxod aiR asoxo bm ■ ()pua _ BaiB ucaj jo » 
OaAom BaoB ucccj Jauqx 9 'uofiAxod auq dn UBaxo oq paxXBO sx OuofiAxodTasoxo » 



;«au = [AE]auxx 

A qsTI auxTUBOS cqux afipa «su uxEip ♦/ ; [AB]auxx = 3xau<-«au 

( 

{ 

{ 

:asBq x<-wau =+ oejj x<-«au 
.'ufixs x<-«au =+ x<-«au 

} (0 > objj x<-nsu)_ axTUM 
A sod-x dn xxj pus ♦/ .'ppB x<-nau =- oeij x<-«au 
A auxx ^xau qje;s */ .'Ae++ 
A V?is qsnCpE umop fiuxpsav s,qx jx */ ) (0 = A~B}X3P) JT 
A -qT uaqious os • • */ _ : (uax<-«au) — _ 

A ^TP SUJBS auq ux fiuxofi sx auxx */ ) (A~Bqxap = B^x^P PXO) jx 

;px — quaxiruD = px<-«au 

A " • "Jjnq.s oTjxoads-uofiAxod aioqs */ .' Aqxsuaqux - Axod = AjTsuaqux<-«au 
A S"0 cq uox^objj azxTBxqxux */ .'x « pp B_ x<-«au = oexjTx<-«au 

A anxEA -sqB pus •• */ .' (xq - xb) : (xb - xq) £ (xb < xq) = ppE~x<-«au 
A ' "ufixs aqciBdas */ tx- : x I (xb < xq) = u&xs x<-«au 

A x jo anxEA fiuxqjB^s .'xb =_x<-«au 

A sauxqnca weip-auxx ux sb 'nasxj,, */ !uax<-«au = aseq x<-«au 

£Ab - Aq = uax<-«au 

A aorqoruqs afipa nau e qafi */ i ( (afipa) joazxs)uiaqx qafi (♦ afipa) = «au 

{ 

idbjar^. = Aq = Ae ;Ae = dmsq. 
.'diraq. = xq .'xq = xe :xe = duiaq. 



- 



eie 



.'qno* 'ur* xa^ra/v tprurqs 
(afipa 'umu '^no 'ux)rtEip Axod 
A 

-q.unoo-xaqj3A paqBpdrt ire fiuxssEd puB sjrajjtiq ,ano„ pub ,,ixt„ * 
am 30 S3TOI atn BurddEMS 'asiroai aw 'aspviaiRO -uofiAxod poddixo * 
-Attvi am AEXdsTp AiTerepe cq pueuiujdo ()«aip saiE puE ()aAOUi eaoB auq * 
asn a« (£ a£pa) a&Pa isei a<G- s.cvt 31 -en peddixo ^snf aA.art jaqmnu * 
a£pa aia :>pa<P a» 'a£>pa uaAXfe b oq. saox^iaA aiQ TTB peddTI=> aA.art aouo * 

* 

xapux aia duauraooux pus jajjnq-^ndtino ain a}Epdn art 'axqrsxA it 'pue * 
'Aa-TiqisTA J03 ^urodpua s,a£pa uofiAxod a^R- sspaip autino* (JaxorsxA am * 
•xapux oaijnq-iixtino ain ^uauiaaoin: art pus 'aajiriq-^tvi^nD atn saqspdn * 
ok 'os JT .'a6pe dxxo ain sqoasiaiux uoxq.Eiapxsuoo japun a6pa ain * 
IX °1 fes" s T «it3«az ()¥»SJ93UX am -tRJoj os pue 'pixin * 

an oa puoces ain 'xa^raA puooas am oq. ^soxj ain maij afcpa atR. sipaip * 
iTTBxauanbas unjj&oad am uaiR .'^saxi at» oq xaq^aA qsBX aiR 10023 a6pa * 
am sx paipaip a6pe ^sxrj am -A^xtxqxsxA pue uoxqoasuaqux 203 qx * 
fiuxqsaq' 'afcpa uofcAxpd ipsa u&nOLnjq sutu uiEj&oid aia 30 doox uteui am * 

•qsuxBfcB dxio oq (den 'uEXMoq 'qu&TJ 'qjax) a&pa W saxjxoads ♦ 
uoxTrt 'e oq 0 uiDjj'jaqmnu b '..afcpa,, sx jaqauieiBd qsBX am --laijxiq qndux * 
auiui saoxvaA 30 jaqconu ayq jo qunoo e sb ixart sb '<n ^no uaqqTJrt , 
aoB saoxqoaA paddxxo-AXftau aqq uoxn« a"° ™"J P" 233 OT saoxqjaA * 
upxq« auo '..sxajjnq xaqoaA,, o«q passBd sx auxqmi am -saxoBpunoq * 
uaaos ain urqqTrt oq uoMiod b sdxjp AxaAXsaroaa auxqncu ()«Bap A T od am » 

{ 

.' (TinN)soxxjdBi5_lpra 
: ()pua BaiB 

; (pi)asoxoj 

.' („;rapEau uoMxod a^aidUE)OUX 11 )^und UOK =i J") JT 
:(0 'U 'Z _ -iajJ«l 'T _ aajJtiq)rtBip _ Alod 

= A-[x]ljtajjnq 
;x = x-[x]i ^ajjxiq 
.' („q.sxt xaqjaA jo pua pe^oadxaun.J^und 

(Z =i 'X9 ',.P%P%,i 'PJ)Jubosj) jx 

}_(++x ;u > x .'0 = T) ^OJ 
i (000T / Arcsuajux xeal * Aycsu33UT)uad - 3as 
; („a£iUBa jo ^no iaxsua^ux uo6Axod„)^und 

(0001 < Aixsuavrx I I 0 > A}xsua}ux) JT 
'(..uciATod ux saox^aA Auem 004 :aoxia TEiuaiux.J^H™ 5 

(3ZIS A =< u) JT 

} ( Z = ( (A^TSuaWS 'U9 '„?%?%., 'PJ)JUB0SJ = IU» 3TXX{« 

; ((xa^taA qoru^s) joazxs * azis a)"b^-T 3? 6 

(* xa^oaA ^onps) = z Jajjm 
i ((xavaA 3oru^s)joazxs * azis A)ma^T I s6 
/ ¥ saajjnq xavaA uta^x-ooot ofn ♦/ (* xa^aA qotvns) = 1 Jajjxiq 

•'(»aTTJ patjxoads uado ^.upTnoo.J^und 

' (-non = ( ( lr i„ '[T]A6ie)uadoi = pi)) JT 
.' (..auieuaTTj dTioAiod :xBViAS„)^und 

( Z =i ote) JT 

; (SAaaD)soTi{dEj5 q.xux 

U sAexre 04 sia^uxod */ i 3~J3J 3«q* 'I - Jajjiiq» xa^caA ^oro^s 
/* aipuBH aixj ♦/ Ouadoj, 'pj* alia 

A xaqjaA jo uo-c^Tsod (A'x) */ ' x 
/» uo&Aiod 30 A^TSuacurr */ 'A^xsua^ux 



/if uobK\o& ux saoxqjaA 30 jaqumu »/ ' u W 

/, jueos iikxij spxaxj 10 jacpnu */ -J u 

/* peoi; joj jaqunoo xavaA */ T IHOHS ^ 

:o£ob ^UT 
(a£ob 'o£ob)uxbui 

0001 3ZIS""A auTJaP# 

/♦ axpusq ubo uiBoficad ain uo6Axod aiqrssod ^satoi at« saxjxoads 3ZIS A */ 

•'{ 

/* q.uxod 30 a^Buxpaoco-A */ t& JMCHS 

/* auxod 30 aq.BUxpaooo-x */ -x IHOHS 

' ) xavaA 3oru^s 

: ()pua~BaxE ' ()rteap~BaiB ' ( ) aAOuTeaie pxoA 
; Otna^T 3-a6* JBip 
..q-auTLpBui,, apniouxf 
<y-oxpqs> apnTpux# 

A 

•uaaoos aio uo ^13 oq. peddxio aJB suofiAxod * 
andano am " suoxqdxjosap uoMxod Buxuxb^uoo (auxx puBuiuco ain uo * 
pax3Xoads) aiT3 b wxlj ' sx ' qndui -suoEiATpd petHJ 9&tdBTP ut^tfioad srm » 



{ 

idtusci uirqai 

i(„Aioui3ui 30 qriOHJqund (0 = ((a2T s 'X)ooxv^ = otaaq) ) jx 

) 

.'azxs q.ux 
(azTs)uiaqx~4a6* ibuo 
/» 

•azxs pax3Toads aio 30 ajoubui 30 )poiq b sumqai^puB * 
OooxiBO snoatp-joxta qEin auxqnoa /axxxqn-XBiauafi e sx ()uraqx qa6 » 

( 

A jaquxod qsxx-jo-pua auq a^Bpdn »/ id uiriqa^ 

.'3X3U = d 

{ 

.'aseq x<-qxau 0E13 x<-qxau 
;u6xs x<-3xau =+■ x<-qxau 

) (0 > OE13 x<-ixau) aXTU« 
ipps x<-qxau =- 0E13 x<-qxau 

) asxa 

( 

.' (qxau)aai3 
;qxau<-5xau = qxau<-d 

) (0 > (uax<-qxau)— ) JT 

(qxau<^l = qxau) axT«« 
jqxau* afipa aaq.sx6ao: 

:d» a&pe ^a^sxfiaJ 
(d)qsxx _ aqepdn Jf a&pa ox^s 



006 00S 
006 005 
006 005 
006 005 
006 005 
006 005 
006 005 
006 005 
006 005 
006 005 



OOT OSS 
001 OOS 
001 OSS' 
OOT OOfr 
OOT OSE 

ooi ooe 
001 osz 
OOT 003 
OOT 05T 
OOT OOT 



OOT OOS 
OOT 056 
OOT 009 
OOT OSE 
OOT OOE 
OOT OSS 
OOT OOZ 
OOT 05T 
OOT OOT 
OOT 05 



£95 


z 


OOS 


z 


8£fr 


c 


SiX 


e 


ETC 


E 


OSZ 


E 


88T 


E 


SZI 


e 


E9 


c 


0 


E 



Z &\od -g-zi inBjgojd 



OOZ osz 
OOE OOS 
08 00* 
OOT 006 
OT OSS 
OOOT 5 

005 009 
OOZ. OOE 

006 008 
OSE E 

OOE OOZ 
OOS OOT 
00* OOE 
OOE OOT 
058 



{ 

.'T uxnqax 

{ 

;:5{Baxq .'o uxrq.ax_(o > A) JT : E aseo 
.'X^aiq io uxnqax (azxs_A =< A) jx :z aseo 
.'3{Eaxq ;o uxnqax (azxs x =< x) jx :t asBO 

.'XBaxq ;o uxnqax (o > x) jx :o aseo 

} (afipa) ipq™s 

} 

.'a&pa JHOHS 
/A 'X JHOHS xsqsx&ax 
(a&pa 'A 'x)axqxsTA 
A 

•axqtsTAiiT/aTqTSTA xoj o xo T suxrqax * 
qi -qsuieDB paddxxo fcuxaq sx afipa vpxuw sauxjap qpxuw JHOHS aq} W 1 * 
fiuoxe quxcd e jo aqBuxpxooo-A pus -x aqq passed sx aurqmx axdurxs sxuj, * 

*/ 



.'X uxnqai 
iO = AoqiTisax 

! <(ta-)*(ta-za)/(tx-zx) (iron)) cms] i + t* = ^r^ 1 ^ 

UL .<o UXnqax ((0 > zA) = (o > iA)) jt 



3SBO 



:t aseo 



.'T uxnqax 
.'qA = Aoqxrisai 

; ((xA - qA)*(lA-zA)/(xx-zx) (jHOli)) (JHOHS) + TX = x<-qxnsax 
.'0 uxnqax ( (qA < zA) = (qA < xA)) it 

,'T uxriqaa 

.' ((TX - qx)*(TX-ZX)/(TA-zA) (iTOli) ) (JHOHS) + TA = A<-qxrisax 

.'qx = xoqinsax 
.'0 uxnqax ( (qx < zx) = (qx < xx) ) jt 

.'T uxnqax 

.' ((TX-)*(TX-ZX)/(TA-zA) tiSKJU)) (JHOHS ) + TA = A<-qxnsai 

.'0 = x<-qxnsao: 
;o uxnqax ( (o > zx) = (o > Tx) ) 

:o 

) (a6pa) qoqxfls 

A dn-paads »/ a - azxs - A = qA 'T - azxs - x = qx JHOHS xaqsxoax ^ 

rqx^sax* xaqxaA qonxqs xaqsxfiax 
.'a6pa JHOHS 
.'ZA 'zx 'TA 'TX JHOHS xaqsxbax 
(qinsax 'afcpa 'zA 'zx 'tA ' ix) qoasxaqux 

A 

-pauxrtqax sx uoxqoasxaqux ub pue 'auxx oxaz * 
aqq jo sapxs aqxsociiD uo axe sx puB tx 'asTBj sx qsaq sxqq uaq« * 
'snqj, 'oxaz ueqq xaqeaxfi axe qqoq uaUM xo 'oxaz ueuq ssax axe zx * 
pue pc qqoq uau« Atuo anxq sx qsaq sxqx " ( (0 > zx) = (o > TX) ) » 
ux se 'suosxxeduDO jo sqxnsax aqq fiuxjwiuoo jo poqqaui aqq aoxqoN * 

* 

•auxqnox puexxaqqns-uaupo aqq se auies aqq Axa6xBi sr uoxqounx sxqi, * 
■T siurqoi pub arcvjonxis .ATnsaa,, aia oyiz }ixtod uox^oasxa^ux (A'x) aifi * 
s^nd ^x 'asxj>uaq^o :o sunxiax uo-pounj aq^ 'uox^Dasxaqux ou si araq} J I * 
•ux xaMsire aqa Vid o^ airponxis xavaA B pue ; (e-o) afipa au^. jo jraqmnu aqi f 
fiuxpioq JHOHS e .'aopa ato fiuxuxjap saq.euxpaooo xnoj aqx passed s,q.i -afcpa * 
uaaoos B ux™ afepa uofiAxod b ftrpoasxa^ux saxpueq uox^ourvi O^oasiaqux aqx * 

*/ 

( 

( 

.' (A<-xd 'x<-xd)rtBxp ears 
(Td++ 't-h- :C > x .'[Tl^no? = Td 'T = T)_ xoj 
•'(A - [o]^no 'x-[o]^no)aAOUi eaxe 
/* ;s4urod 3W3S seq uoM[od au^ a-tns a^Biu */ _ ) (0 < f) JT asTa 
/, a6pa'^xau dxxo ♦/ : (a£ipa++ 'C 'ux '^no)«exp Axod (£ > afipe) j| 

A sq.uamaioux zd 'arvreA pxo s,zd sa>(e^ id */ ;++zd = id 

( 

.'C++ 

:A<-zd = A- [ C]3rio 
:x<-zd = x - [C]^no 
} ( (afipa 'A<-zd 'x<-zd)axqxsXA) jx 
•'P-H- 

(([C]4TVD5 'afipa 'A<-zd 'x<-zd 'A<-xd 'x<-Td)3oasxa5UX) it 

) (x++ .'umu > x ;o = T) xoj 
A siuauiaaoux pub q.uxod iSHLi uo s^ie^s zd */ .'[oluxis = zd 

A Axod 303UUOO oq. }uxcd JSVI uo xd q-reqs */ .' [T-umu]uxis = id 

A saoxpux vidino pue ^ndux */ .'o = C 'x JHOHS xaqsxfiai 

A a6pa Axod jo squxodpua */ .'zd» 'xd, xaqxaA qoroqs xaqsx6ai 

} 

:a6pa 'umu JHOHS xaq.sT.6ai 
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{ 

•' (TinN) soxydeiS ^rxa 
( 

.'(({f)urs * [xlsnrpEj: * azxs_A) (jxohs) + X. 
'((C)soo * [TjsnxpEJ * 3ZTS X) (IH0HS)_+ x 

'A 'x)3urx paddxxo 
(08T/ld =f f -'Id*Z > C .'0 = Q ZO} 
'. [T]aaqu30_A * bzts_A = A 

i [X]J3^U30 _ X * 3ZTS X = X 

.' ([T]aoxooju3cT"q.3s 

} (T++ .'9 > T -0 = Ti 
•' (saOT<x>)soTtfdEj£> q.Tut 

.'C JHDIi 
:A 'X 'T JHOHS 

( CHH 'NWO 'N33H3 'SHOT '3HHM > = [9]JOXOO JHDHS OT^B^S 

i( 0T- '08- 'SZ - 'S3 - 'OS" 'Of } = [9]srvrpei ZHOU OX^S^S 
.'{ 08- 'i'T 'Of 'Of 'ST 'OS - } = [9]ja}uao_A JWCTU OT^B^S 
!( 08- '09- 'Of '08- 'SZ- 'OS" } = [9]Jnuao X JtfOli OT^B^S 

Quteui 
A 

..•sxaaitA,, xrs jo ..sastods,, am maip cq. sur^nca OaurxdTio aq^. asn * 

*/ 

6S£S9Z6STtt-£ Id auxjap# 
: ()soo ' ()uts atqnop 
..q-auTipBui,, 3pnToux# 
<q-oxpqs> 3pnTaux# 
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081 09£ 
0001 8 



OS OSfr 
001 oos 
OS OSS 

0 OOS 

OOS 

OC 08Z 
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006 OOS 
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006 OOS 
006 OOS 



00X 006 
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00X 008 
OOX OSZ. 
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OOX 009 



OOX 0S8 
OOX 008 
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OOX OOZ. 
OOX 0S9 
OOX 009 
OOX OSS 
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SZ.8 £ 

£X8 £ 

OSZ. £ 
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Amiga Lattice 

Enter the command execute cc machine The cc script (see 
Appendix D) should load and run lcl and lc2. If all goes well, 
you'll have a working copy of machine. c. 

ST Alcyon 

Double-click the hatch.ttp program and give it the arguments 
cf machine. When it's finished you should have a file called 
machines. Watch carefully, since hatch.ttp doesn't stop if 
there's been any kind of error. 

ST Lattite 

Double-click the lc.ttp program and give it the arguments 
machinac. If you've moved the include files into another di- 
rectory, you have to use the -I option to tell the compiler 
where to find them. 

ST Megamax 

From witnin the graphical shell, select the compiler option in 
the execute menu, and indicate that you want to compile 
machinac. Remember, you have to tell the shell where it can 
find all of the files before you try compiling anything (see the 
Megamax manual for more details). 

macldne.c isn't a complete program. Instead, it's just a set 
of functions which other programs can use to create graphics 
displays. For Alcyon compiler users, it also corrects some prob- 
lems which exist in the supplied library of functions. 

Program E-l Amiga machine.c 



# include <exec/types.h> 
^include <jntuition/intuition.h> 
# include <stdio.h> 
# include "nachine.h" 

/* This is the machine-dependent module for graphics on the Amiga. 

* Included in this module are the functions 
* 

* init_graphics() ; initialize graphics environment 

* exit graphics ( ) ; return to normal working environment 

* get input () ; get user input into a buffer 

* serpen () ; set pen color/grey shade intensity 

* move() ; wve to a 9 iven pixel position 

* drcw() ; draw a line to a given position 

* plotQ i plot a pixel at a given location 

* clear () ; clear display screen 

* puit() ; exit with error 
* 

* :nit_gr«phics() sets global variables x_size, y_size, and max_intensity. 
*/ 
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/* system functions */ 
extern struct Screen *OpenScreen ( ) ; 
extern struct Literary *openUi>rary() ; 
extern struct Viewport *ViewPortAddress() ; 

/* system variables */ 

struct IntuitionBase *IntuitionBase = NULL, 
struct GfxBase *GfxBase = NULL; 
struct Screen *screen = NULL; 
struct RastPort *rp; 

/* public variables */ . 

SHORT x_size , y_size, max_intensity, intensity; 



'** init_graphics sets up the graphics bitmap for use. 
V 

struct NewScreen newscreen = { 

0, 0, MAXPIXELS, MAXLTNE, 0, 0, 1, NULL, 
CUSTCMSCREEN, NULL, NULL, NULL, NULL 



/* public to system */ 

/* screen and its rastport */ 



/* standard colormap (GEM map with black and white reversed) 
UWDRD colormap [ 16 ] ; 

void imtjgraphics(reqjnode) 
int reqjtode; 



V 



{ 



long i; 

static UTORD colors [] 
0x0000 /* black */< 
OxOfOO /* red */, 
OxOOOf /* blue */, 
OxOffO /* yellow */, 



OxOfff /* white */ 
OxOOfO /* green */ 
OxOOff /* cyan */. 
OxOfOf /* magenta 



newscreen. Depth = (reqjncde = GREYS) . 
x_size = MAXPIXELS; 
y size = MAXLINE; 

mix_intensity = (1 « newscreen. Depth) 
intensity = -1; 



4 : 3; 



/* 
if 



if 



if 



open libraries and screen */ 
OlntuitionBase = (struct IntuitionBase *) 
OpenLiirary ("intuition. library", 0L)) = NULL) 

punt ("couldn't open intuition") ; 
((GfxBase = (struct GfxBase *) 
OpenLibrary(»graphics.litorary", OL ) = NULL) 

punt ("couldn't open graphics library ) , 
((screen = OpenScreen(&newscreen) ) = NULL) 
punt ("couldn't open screen") ; 

ZZ^r^r^)* snail hack for Amiga AreaFill hack V 

/* assign colors (either as grey-shades or colors) */ 
if (reqjmode -== GREYS) 

for (i = 0; i <= max_intensity; ++i) 

colormap[i] = i I (i « 4) I t 1 <<: . 8 ' ; 
else for (i = 0; i < 8; ++i) colormap[i] = colors [i]; 
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static SHORT oldoolors[16] [3] ; /* array for original color values */ 

static SHORT logscr = TEXT; 

static long textscr; 

static char 'screenmap; 

static void showscreen() , usescreen() ; 

((include <liiea.h> 

((define ntETfl lineaO() 

#define FOTRK(p) lineal () 

#define ABUH:(p) linea3() 

#else 

/* defines for the IZNEA calls */ 
char *la_base, *INIT() ; 
int RTTPDCO , ARUTNEQ ; 

((define ODNTRL (*(SHOKT **) Sla_base[4] ) 

((define BTITN (* (SHORT **) £,la_base[8] ) 

((define PTSIN (*(SHORT **) &la_base[12] ) 

((define INICTX (* (SHORT **) &la_base[16] ) 

((define FTSOUT (* (SHORT **) &la_base[20] ) 

((define OOLBITO (* (SHORT *) &la_base[24] ) 

((define OOIBIT1 (* (SHORT *) &la_base[26] ) 

#define OOIBm (*(SHORT *)&la_base[28]) 

#define O0IBtT3 (* (SHORT *) &la_base[30] ) 

((define LSTLD (* (SHORT *) &la_base[32] ) 

((define UMASt (*(SHORT *)&la_base[34]) 

(fdefine MODE (* (SHORT *) &la_base[36] ) 

#define XL (*(SHORT *) &la_base[38] ) 

((define Yl (* (SHORT *) &la_base[40] ) 

((define X2 (* (SHORT *) &la_base[42] ) 

((define Y2 (* (SHORT *)&la_base[44]) 

(tendif 

/* 

* initjgraphics sets up the graphics bitmap for use. 
V 

raid init_graEhics (reqjnode) 
int reqjnode; 

( 

SHORT dummy, work_in[ll], work_out[57] , rgb_in[3]; 
register SHORT i; 

textscr = (long) Physbase() ; 

if ((screenmap = malice (65535) ) = NULL) { 

printf ("couldn't allocate memory for new screen. \n") ; 

exit(l) ; 

} 

graphscr = ( (unsigned long) screenmap & ' (0x7f ffL) ) + 32768L; 
if (appl_init() < 0) { 

printf ("couldn't initialize application! \n") ; 

exit(l) ; 

) 

handle = graf_handle(&dummy, &dummy, Sdummy, &dummy) ; 
for (i= 0; i < 10; i++) work_in[iJ = 1; 
work_ii[10] = 2; 

if (v_«pnvwk(work_in, &handle, work_out) = 0) 

punt( "couldn't open virtual workstation") ; 
for (i = 0; i < 8; ++i) 

vg_color(handle, i, 1, Soldcolorsfi] [0]) ; 
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x_size = work_out[0]+l; 
y_size = work_out[l]+l; 
if (x_size = 640 && y_size — 200) 

punt("can't run in medium resolution 1 ") • 

3-M^ er -^ r 5ff le) '' /* "eed text on screen */ 
v_hide_c (handle) ; ' 
intensity = -l; 
colorjnode = reqjnode; 

if ^-^U^rl L , 7 * ^ ° n nonochrome screen */ 

vsljtype (handle, (SHORT) 7) ; ' 

max_intensity = DITHER * DITHER; 

init_dither() ; 

vs_color(handle, (SHORT) o, Scolors[0] roi) ; 
vs_oolor(handle, (SHORT) 1, &colors[lH0]) ! 

else ( 

for (i = 0; i < 8; ++i) { 

if (reqjnode = O0IDRS) 

else { vb_oo1ot (handle, i, &colors[i] [0]) ; 

rgb_in[0] = rgb_in[l] = rgb_in[2] = i*l000/7; 
^ vs_color (handle, i, rgb_in) ; 

) 

max_intensity = 7; 

#if MWC 

INTT() ; 

#else 

la_base = INIT() ; 
OONTRL = contrl; 
1NTIN = intin; 
PTSIN = ptsin; 
INICUT = intout; 
FTSOUT = ptsout; 

#endif 

clear () ; 

shewscreen (GRAPH) ; 



/* 

** StLf ^ P 31 * 6 ™ is set up is suitable for direct 

Pixel dither operations. Tne "dmatrix" array is dynamical^ 

* S^ te lf ar H? 6 aPPropriate-size dither pattern (DITHER) . 

* S^^^ e ' Pattem amy is *y through all the 

* ^tensity/line contortions and crLti^the bit 

* f °^ the ralUmS - ^ array must 
ce accessed by adding offsets to the base pointer, since its 

* size is dynamically created. To expedite the routing 

S d muTS?v ^ ! iS <a ^ so ^ - have 

^to multiply (it's statically allocated to save trouble) . 

init_dither() 

register SHORT i, j, k, s, d; 
register unsigned SHORT *p, n; 
register SHORT size_sgr; 

SHORT dmatrixCDITHER] [DITHER] ; /* temp dither matrix */ 

dmatrix[0] [0] = 0; /* initial state */ 
for (s = 1; s < DITHER; s *= 2) 
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C0IBIT2 = (intensity » 2) & 1; 
C0IBIT3 = (intensity » 3) & 1; 
INMASK = Oxffff ; 

} 

WMODE = 0; 
usescreen (GRAPH) ; 
AHUNE(la_base) ; 
us«screen(TErXT) J 

) 

/* 

* Plot the point x,y. 
V 

void plot (i, y) 

INHNfO] = intensity; 
PTSIN[0] = x; 
EBJN[1] = y; 
usiscreen (GRAPH) ; 
PUTPIX(la_base) ; 
usescreen(TEXT) ; 

) 

/* 

* Clear tie screen. 

V 

void clear() 

( 

register int i; 
register long *p; 

p = (long *) graphscr; 

far (i = 8000; i; — i) *(p++) - OL; 

) 

7 * punt() takes a string parameter which it passes to exitjgraphics ( ) 

* and then exits with an error. 

V 

void puntjs) 
char *s; 

' eiit_graphics ( s) ; 

eiit(l) ; 

) 

/* 

* Set the logical screen to GRAPH or TEXT 

V 

static vo.d usescreen(a) 
register Jit a; 

i: (a = logscr) return; 

ii (a - GRAPH) Setscreen (graphscr, -1L, -1) ; 

else if (a = TEXT) Setscreen (textscr, -1L, -1) ; 

eise return; 

logscr = a; 

) 

/* 

* Set the physical screen to GRAPH or TEXT 
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*/ 

static void showscreen(a) 
register int a; 

if (a = physscr) return; 

if (a = GRAPH) Setscreen(-lL,graphscr,-l) ; 

else if (a = TEXT) Setscreen (-1L, textscr, -1) ; 

else return; 

physscr = a; 

> 

#if ADCYON 

7 * the missing atoi() function: convert a string into an integer 
V 

int atoi(p) 
register char *p; 

reqister unsigned int i = 0 ; 

register int neg = 0; /* default to positive number */ 

while (*p = ' 1 | | *p = '\t') /* ignore leading white space */ 

if _ / /* look for - sign */ 

neg = I; /* number is negative */ 

++p; 

else if (*p = •+') ++p; /* number is positive */ 

while (*p >= '0' && *p <= '9') ( 

i = i*10 + (*p - '0') ; 

++p; 

) 

return neg ? -i : x; 

) 

/ * function gets() since the one from Atari is broken. Check for 

* If, cr, or EOF for end of input line. Return NULL if EOF is 

* sent. Handle -H and -? rubout. Can't get at the re-directed stdin. 

*/ 

char *gets(p) 
char *p; 

register unsigned char *c = p; 
register unsigned char in; 

while ((in = CnecinO) != r V»' SS in != '\r' && in != 26) 
if (in == '\b' | | in = 0x7f) ( 

lf (C ""cconoutCXb 1 ); Cconoutf '); Ccpnout('Sj3') ; 

> 

else cconout(*c++ = in) ; 
Cconout('\r') ; Cconout( '\n' ) ; 
*c = '\0< ; 

return (in = 26) ? NUli : p; 

) 

*endif 
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/* define xmpiler type */ 
#def ine MESAMAX 1 
#def ine IATICE 0 
#def ine ALSTON 0 
#def ine MKC 0 



#if MEGAMftf 
#def ine SHJKT 
#define ZE3D 
#def ine vo.d 
#else 

^define SH)RT 
#define ZEO 
#endif 

#if iArnc 

#def ine FIHAT 
#else 

jtdefine FliAT 
#endif 



int 
0.0 
int 

short 



double 



float 



/* Megamax version 1.1 */ 

/* lattice version 3.03 */ 

/* DRI Developer's compiler 4.14 */ 

/* Mark Williams C */ 



/* 


shorts are 16 bits 


V 


/* 


avoid negation bug 


V 


/* 


Megamax doesn't use the void type 


V 


/* 


shorts are the standard 16 bits 


*/ 


/* 


no negation bug 


*/ 


/* 


floats work best as doubles 


V 


/* 


normally float is faster 


V 



tfifndef NUi 
#def ine NUX 0L 
#endif 

/* Notice ve avoid the #else construct since Megamax becomes confused */ 
#if (AIOTCK | MEGAMAX) = 0 
extern chai *malloc() , *calloc() ; 
#endif 



#if AI£Y0N | MEGAMAX 
#define maZloc(s) 
#define fr*e(p) 

# ifndef Hysbase 

# include -<osbind.h> 

# endif 
#endif 



/* defines for call to init_graphics() */ 
#define GRTCS 0 
#def ine OOXJRS 1 



(char*) Malloc((long) (s) ) 
Mfree((char *) (p) ) 

/* see if osbind.h has been li 



#def ine BUCK 
#def ine WHITE 
#define REJ 
#define GRIEN 
#define HUE 
#def ine cm 
#define YEE0W 



#def ine MACENTA 7 



extern SHOET x_size, y_size, max_intensity; 

extern voic init_graphics ( ) , exit_graphics ( ) ; 

extern void set_pen() , moveQ, draw(), plot(), clear () , punt() ; 

extern chai *get_input ( ) ; 



/* define this as the machine's 
#define M&XZNE 400 
((define MAJPIXELS 640 



screen's x- and y-size */ 
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Appendix F 

Special Compiling 
Instructions 

This appendix explains how most of the sample programs in 
this book should be compiled. If there's a program which 
doesn't have explicit instructions, you should use the previous 
examples as illustrations. In all cases, the Atari ST programs 
should be renamed .TOS, or installed as TOS programs. 

If you're using the Alcyon compiler on the ST, you should 
consider changing the default stack size in the gemstart.s file. 
If you haven't done so already, we recommend that you 
change the stack to be 4K (you need to change the $500 to 
$1100; the file is well commented and the change you need to 
make is towards the top of the file). 

Programmers using the ST without a command line inter- 
preter are faced with a small problem. Most of the programs 
don't wait for you to press a key when they exit. When run 
from the GEM desktop, the program prints its output, and 
then returns to the desktop. This means the output flashes on 
the screen briefly, and is cleared in order to redraw the desk- 
top. If you don't have a command line interpreter, we suggest 
that you add the following lines to the ends of the programs 
(just before the last closing brace at the end of mainC )): 

printfC'Press RBTT7RXT to exit:"); 
getcharC ); 

Make sure that the line "include <stdlo.n> has been included 
in the program. That line has to be there for this fix to work. 

We haven't included instructions on how to compile every 
program in the book. The instructions for each program ex- 
pand on the instructions from the last. Only those programs 
which have to be compiled in a special or new way have been 
included. 
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INPUT figs.bin 
INPUT mach.ine.bln 
INPUT linea.bin 

Go to the end of the file and remove the • in front of the 
line which reads LIBRARY GEMLIB (this uncomments that 
line). Save the modified clnk as figs.lnk. Run link.ttp with 
the argnements 

- with FIGS.LNK -nolist 

Don't forget to rename the figs.prg, figs.tos. 

ST Megamax 

Select the link option from the execute menu, and use the file- 
description dialog box to select figs.o, machine. o, and 
linea.o Change the name of the output file to figs.tos, and 
run the linker. Rename the figs.prg, figs.tos. 

Compiling divide.c 

ST Alcyon 

You need to change the program to read as shown in Program 
F-l. 

Program F-l. ST Alcyon Version of divide.c 

/* 

* divide, c — fractional division using integers 
*/ 

/* 

* includt file; we're using printf Q and scanf () , so we should 

* get sane of the definitions from stdio.h so the compiler 

* knows that's going on. 
*/ 

#include <stdio.h> 

main() 
( 

char buf fer[256] ; /* space for the input line */ 

irt divd, /* dividend */ 

divs, /* divisor */ 

quot, /* quotient */ 

remain; /* remainder */ 

/* 

* get the number to be divided using scanf () ; the use of 

* scanfQ and the & operator will be discussed later. 

V 

printf ("Input the dividend: ") ; 
gees (buffer) ; 

sscanf (buffer, "%d", &divd) ; 
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/* 

* get the number to divide by using scanf () 
V 

printf ("Input the divisor: ") ; 
gets (buffer) ; 

sscanf (buffer, "%d", &divs) ; 

quot = divd / divs; /* calculate the quotient */ 

remain = divd % divs; /* and the remainder */ 

/* 

* print the results using printf () . Notice that we have to 

* keep the arguments ordered the same way we want them to 

* fill in the "%d" escapes. Notice also that we're allowed 

* to break program lines if they get too long to fit 

* on the screen. 
*/ 

printf ("%d divided by %d is %d %d/%d\n", 
divd, divs, quot, remain, divs) ; 

) 

Compile the program the same way you compiled 
hello.c. To link the program, use the following batch file: 

linlc68.prg 

divide.68k=gemstart,divide,macliine,linea, 
aeBbind,vdibind,osbind,gemlib,libf 

relmod.prg divide. 68k 

rm.prg divide. 68k 

wait.prg 

This links the divide.o file with xnachine.o since the 
functions atoiO, and getsO are needed by this program 
(sscanfO calls atoiO). 

Other Compilers 

Follow the instructions for hello.c. 

Compiling fact.c 

Lattice 

This applies to both the Amiga and the ST: The compiler will 
generate a "function return type mismatch" warning. The pro- 
gram is all right as it stands. 

ST Alcyon 

The printfC } function doesn't appear to support the %.0f very 
well. For all of the numbers, it prints one digit after the deci- 
mal. This makes some of the numbers nonsensical. 

Other Compilers 

There should be no warnings or errors from the other 
compilers. 
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ST Megamax 

From within the graphical shell, select the linker from the Exe 

%£^tt££%£?* *« «* 

graph, o 

math.o 

fileio.o 

help.o 

dxaw.o 

Don't forget to include machine.o and linea.o Chanee the 
name of the output file to grapn.tos and execute the finker 
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Appendix G 

Using the Graphics Library 



This appendix was written to document the routines in the 
graphics library. Each entry has at least four parts: 

Name The name of the function and a one-line description of 
what it does. 

Synopsis Indicates how the function should be used, and what ar- 
guments it expects. 
Discussion Describes, in detail, what the function does. 
Example Gives one way in which the function can be used. 

Some entries might also include: 

See also Where related reference material might be found. 
Bugs Anything that might be wrong or misleading about the 

function. 

The graphics library includes three global variables and 
some definitions which you might find useful. The global vari- 
ables are as follows: 

x_size is the number of pixel columns on the graphics display 
screen. 

y_size is the number of pixel rows on the graphics display screen, 
max—intensity is the largest value you can pass to set— colorC ). 

Generally, max— intensity is used to determine the num- 
ber of grey shades your program can use. The two definitions 
which are provided are MAXPIXEL, which is the largest value 
x_ size might hold, and MAXLINBS, the largest value y_size 
might hold. 

Name: 

clearC ) 

Clear the graphics screen 
Synopsis: 

void clearC )> /* takes no arguments */ 

Discussion: 

Clears the screen on which the graphics rendering is be- 
ing performed. 
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Name: 

init—graphicsC ) 

Initialize the graphics routines 

Synopsis: 

void dnit— graphics(mode); 

int mode; /* graphics mode to enter */ 

Discussion: 

The routine in.it_graph.icsC ) initializes the machine- 
independent graphics routines, mode is either COLORS or 
GREYS as defined in the file machine.h. What is actually 
performed differs on the Amiga and the ST. 

In boih cases, the end result is a clear graphics screen, 
ready to be used by any of the other graphics routines. 

The global variables x— size and y_size are set to the di- 
mensions af the screen. MAXPIXEL and MAXXXETES are set 
to the largest possible screen for that computer. 

Example: 

init-giapJiicaCCOLOKS); /• initialize for color drawing •/ 

See also: 

exit— {raphicsC ); 

Bugs: 

It's net an error to specify GREYS and try to draw in col- 
ors, init— graphicsC ) also doesn't know if it's been called 
more than once without calling exit— graphicsC ). The Amiga 
could lose vast amounts of memory this way. 

The ST version allocates 64K in order to get a continuous 
piece of memory which is 32K long and aligned on a 32K 
boundary. It should have to allot so much memory per screen. 

An enor while initializing the screen exits the program. 

The initial drawing color is not set. 

Name: 

moveO 

Move the drawing pen 

Synopsis: 

void moveCx, y); 

SHORT x, y; /* coordinates to move to */ 
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DlSC m oveO locates the drawing pen at the specified position 
The next drawO command will draw a line from this point to 
the point specified with drawC )• 

x can vary from 0 to (x_size- 1) and y can vary from 0 to 
(y-size-1) x_si«e and y_size are global variables which are 
set when init-graphicsO is called. 

This command is only simulated on the Atari. 

EXa move e cl86, 1Z>, f move drawing cursor to C1M.10 V 

See also: 

drawC ), init-graphicsC ), plotC ) 

Name: 
plotC ) 

Draw a point 

Synopsis: 

void plotCx, y); 

SHORT x, y; f coordinates to plot a point / 

Discussion: .,, , , A _ 

plotO draws a point at the location specified by x and y. 
The point is plotted in the color specified by the last call to 

86t "x c^ vary from 0 to (x_size-l) and y can vary from 0 to 
(y_size-l). x_size and y_size are global variables which are 
set when init-graphicsC ) is called. 

Example: „„, , „ 

P lotCia6,18); /• plot a point at Cl»6,18) / 

See also: 

drawC D, moveC ), set— penC ) 

Name: 

puntC ) 

Exit the program 

Synopsis: 
puntCs); 

char 's; /* error message */ 
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Name: 

WntTout the buffer of stream 

Synopsis: 

int fflus&Cstream)} 
jriiB •stream; 

DiSC ^> -i.es out the buOer of ^specified 
S Vetoed in 

See also: 
f eloseC ) 

Name: 

SS? input line from a. «~- 

FILE *stream; / 8we 

Discussion: . „ (rnm Btrea m and stores it in the 

D V.C) reads in a ^^ &te re ad from the 
K , lfter pointed to by x. l" e cn a l ararter (\n) or until 
SSSTup to the fust new-tae character ( ^ „ 

characters have been reau. was 
£3 buffer pointed to .by * ^ 
Sed with a new-line^tha^c gtnnfr 
character in the stnng. fgetsO « q{ ^ has bee n 
Tf m error has occurred, or tfte J* 
Iched, then fget-O returns 

Example: 

j-ILB 'infile; 
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f6 etsCbuffer, ^«),« r *-* ^ 
f closeCinfile); /' close file •/ 

See also: 

scanfO, getsO 

Name: 

fopenC ) 

Open a stream 

2S SET /• - ~ — 4 " °"" 4 v 

Discussion: , - n __ ame The mode in- 

are always valid: 

" of P a„ existing file. If thefile doesn't exist, a new one is 
"orTthe ST, most of the compilers support a transl ated and 

PcTn aoo m T o h S »teU. ^S^"^ 

"""Hheffle is opened successfully 
pointer to the open KM structure. I l»P«0 returns 
this means that the file couldn't be opened. 

See also: 
f closeC ) 

B " gS The — file for the ^ tu have^ 

in your program before you first use f opener 
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Only one flag is generally supported. — indicates that the 
result should be left-justified within its output field. Without 
the — flag, the output will be right-justified within the field. 

The only optional size is 1. This means that all integer 
formatting options are being used on long values. Thus %ld 
lets you print a long int as a signed decimal quantity. 

To print a %, use the character sequence %%. 

Each routine returns the number of characters it has writ- 
ten, or a negative number if an error has occurred. 

Example: 

float a - 83.1, to - 34.1; 
cnarlins[ ] - "Hi there \n"; 
int k - 5; 
long d; 

printfC'Jbg %4.8f \n", a, To); /* output two floats •/ 
printfC'message: %-80s", line); /• output a string •/ 
printfC't count %d item%s.\n", k, k>l 9 "s" : " "); 
printfC'aumber: %'d\n", 8, k); /• print k in width of 8 •/ 
printfC'Long value: %ld\n", d); /• print long value */ 

See also: 

scanf C }/ fopenC ) 

Bugs: 

Some compilers don't support %g. 

Name: 
pntsC ) 

Write a string to stdout 
fputsC 2 

Write a string to a stream 

Synopsis: 

int pntiCaO; 

char *x; /* string to output •/ 

int fputsCx, stream); 

char *xj /* string to output */ 

FILE 'stream; /* output stream to write to •/ 

Discussion: 

putsC ) writes the null terminated string pointed to by x 
to the stdout stream. The last character is followed by a new- 
line, to start any new output on the next line of the file. 
tputsC ) does the same thing as putsC ), except the output is 
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sent to the stream pointed to by stream. For either routine, if 
an error occurs, EOF is returned. 

Example: 

char output[ 1 = "line to output"; 
puts(output); /• write line to stdout */ 

See also: 
printf C ) 

Name: 

scanf C ) 

Read formatted input from stdin 
fscanfC ) 

Read formatted input from a stream 
sscanfC ) 

Translate a formatted buffer 

Synopsis: 

int scanfCformat £, arguments...]); 

char 'format; /• translation string •/ 

int fscanfCstream, format £, arguments...!); 
FILE 'stream; /• stream to take input from •/ 
char 'format; /• translation string •/ 

int sscanfCbuffer, format [, arguments...!); 

char "buffer; /• buffer holding formatted input */ 

char 'format; /* translation string •/ 

Discussion: 

The scanfC ) functions are the complement of the 
printfO functions. scanfO takes its input from the stream 
stdin. fscanfC ) reads its input from the named stream, and 
sscanfC ) uses the string pointed to by buffer. The formatting 
string has the same meaning for each routine. scanfO; 
fscanfC ), and sscanfC ) attempt to match the input they read 
with the formatting string. 

Any "white space" (spaces, tabs, or new-line characters) 
in the formatting string force the scanfO functions to read up 
to the next non-white-space character. Ordinary characters 
(not the % or white space) must match in the format string and 
the input. % marks where input is to be translated and stored 
in the memory pointed to by the matching argument. As with 
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Appendix I 

Amiga Graphics 



The purpose of this appendix is to explain the Amiga version 
of the graphics library. To do so, we will begin by briefly ex- 
plaining the organization of the graphics hierarchy on the 
Amiga. 

At the lowest level of the graphics hierarchy is the mem- 
ory which represents what's being displayed on the screen. By 
changing the contents of this memory, we change the picture 
we see. Graphics screens can be placed anywhere in the lower 
512K of the Amiga's addressing space and they can also be a 
variety of different sizes. 

The reason for the flexibility of the Amiga's graphics is its 
powerful set of graphics-support chips. These represent the 
next level of the graphics heirarchy. The chips can draw lines, 
fill areas, and move blocks of memory faster than the central 
processor; and, for the most part, they stay out of the proces- 
sor's way, leaving the processor more time to run programs. 

But all of this hardware isn't anything without the soft- 
ware to support it. The Amiga Kernel routines act as an inter- 
face between the hardware and the software. This lets 
programs access the hardware functions without working with 
the chips directly. When we want to draw a line, for example, 
we call a Kernel routine, which, in turn, gets the hardware to 
draw the line. The level above the Kernel is Intuition. Intuition 
handles the screens, windows, menus, and requesters. It does 
this by making calls to the Kernel. So, whenever Intuition 
needs to put something on the screen, it calls the Kernel, 
which sends the commands to the support hardware, which 
changes the display memory, which changes what we see. 

Figure 1-1. Amiga Graphics Hierarchy 
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exit_graphics( ) 

exlt_graphics( ) does just about the opposite of what 
init_graphicsO does. First, it brings the Workbench screen 
to the front using the Intuition call WBenchToProntC )• Next, 
it prints any error message which might have been passed to' 
it, and then prompts the user to leave the graphics library. 
Once a key has been pressed, it closes the screen, graphics li- 
brary, and the Intuition library. Notice how this is done. If the 
screen or any of the libraries have been opened successfully, 
their pointers will have some value. If they have a value, then 
we close them. Otherwise (if they're OTTJT.I,), they haven't 
been opened. You don't want to close something which hasn't 
been opened; the Amiga tends to crash if you do. 

get_input( ) 

This function really isn't much to look at on the Amiga, but 
was provided because some versions of the graphics library 
have to dD special things in order to get input from the user. 
On the Amiga, this function simply prints a prompt and calls 
getsO. Note that getsO will generally return a pointer to the 
string it just read in. If the user enters end-of-file, or if an er- 
ror occurs, getsC ) returns XTUl.Ii. 

set_pen( ] 

This routine first checks to see if it really has to change the 
drawing color. If it does, it calls the Kernel function 
SetAPenO and then updates intensity to reflect the change. 
This is the reason for initializing intensity to — 1. We are 
guaranteed that new-intensity can't be - 1 (because the 
color can'1 be a negative number), so SetAPenQ will be 
called the first time set_penO is called. Note that almost all 
Amiga routines which take ints expect Lattice ints. Under the 
Aztec compiler, these are longs. This is why we cast 
new_intensity to a long before it is passed to SetAPenC )• 
move( ), draw( ), point( ), clear( ) 

These four routines map directly into Kernel functions. Again, 
notice that we have to cast the arguments to these functions to 
long, since they expect Lattice-sized ints. 

punt( ) 

This short function gives you a quick way out of the program. 
It first calls exit_graphicsC ) to clean up the graphics func- 
tions. Then it leaves the program with a call to exitQ 
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machine.h 

The machine.h file should be included in your program 
whenever you use any functions in the graphics library. This 
file defines the colors, GREYS and COLORS, as well as 
MAXLINTS and MAXPIXELS, Furthermore, it includes defini- 
tions of the global variables x_ siae, y_size, and max_pixels. 
This lets you access them without including the external refer- 
ence yourself, machine.h also defines mallocC ) and callocC ) 
to return pointers to char. Thus, you don't have to do that in 
any program which includes machine.h. 
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are the G1M AES (Application Environment Services) 
routines, "hese are the routines which deal with windows, 
menus, ard dialog boxes. Whenever something needs to be 
put on th« screen, GEM AES calls GEM VDI, which calls 11- 
nea, which changes the display memory, which changes the 
display. 

Figure J-L. ST Graphics Hierarchy 



application 
GEM AES 
GEM VDI 
line a 
display memory 



Graphics Library 

At first glance, the ST version of the graphics library looks far 
more complicated than the Amiga version. Most of the added 
complexit; is due to the monochrome screen. We've had to in- 
clude code to handle dithering and patterned lines in order to 
use the monochrome screen effectively. There is also some 
added complexity because we have to deal with separate 
graphics and text screens. The ST's software wasn't designed 
to deal wrh this kind of separation. We've had to trick some 
of the routines into working correctly on their appropriate 
screens. 

The first thing in the machine. c file for the ST is the dec- 
laration of the system variables. These are the arrays which 
we need to set up in order to communicate with the linea 
functions. Vext, we declare the public variables: x_size and 
y_size are the size of the graphics screen which we're using, 
max— intensity is the largest color value you can use when 
you call set— penC ). physscr indicates which screen, graphics 
or text, is currently displayed on the screen, graphscr points 
to the memory which was allocated to hold the graphics screen. 

Next, we define the size of dither matrix (DITHER), and 
two definitions we need to handle the graphics and text 
screens, pattern is a pointer to the different line and fill pat- 
terns. We'li use this if we're working with the monochrome 
screen. off»ets[] is used to reference the pattern table. We 
could recakulate the offsets every time we need them, but that 
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would be a waste of time. Instead, we calculate all of the off- 
sets once, and store the results in this table. x_ save and 
y_ save are used to fake the moveC ) command; we'll talk 
about that shortly, color-mode will tell us if init— graphicsC ) 
was called with GREY'S or COLORS, intensity is the current 
drawing color; real— intensity holds the color to plot in if 
we're using a monochrome screen. And handle holds the 
graphics handle to the display screen. This is simply a num- 
ber we need to tell AES and VDI which display we're working 
with. In some ways, the graphics handle is to GEM graphics 
programming what the "FILE pointer" is to input/output 
processing. 

mono— col[ ] is a table which lets the monochrome screen 
pretend that it's the color monitor. It translates the eight dif- 
ferent colors into eight different patterns. colors[][3 is the ta- 
ble which specifies the different colors for the GEM routines. 
The numbers specify the intensities of the red, green, and blue 
guns in the monitor. Thus, the color red will be { 1000,0,0 }, 
all red, no green, and no blue. The other colors (like yellow) 
are made by mixing red, green, and blue. 

logscr (along with the public physscr) gives the graphics 
routines a quick way to determine which display is currently 
the "logical" screen (and which is the "physical" screen). Re- 
member, the physical screen is the one which is being dis- 
played on the monitor, while the logical screen is the one 
which is being drawn on. textscr holds the addresses of the 
text screen. Remember, graphscr holds the address of the 
graphics screen. Note that textscr and graphscr are longs 
rather than pointers. The reason we use longs is that many of 
the routines which use these values expect longs, not pointers. 
A long and a pointer are the same length, so type casting be- 
tween them is no problem, screenmap is a pointer to the 
memory which was allocated to hold the graphics screen. 
We'll discuss the showscreen( ) and usescreen( ) routines 
shortly. 

la—base is a pointer to a block of memory which is 
needed by the linea routines. IMTTC ), PUTPIXC ) and 
ABLINB( ) are routines which interface C with the linea 
functions. They're described below. The #defines which follow 
these declarations create names for the various fields in the 
structure pointed to by la_base. This simply makes it easier to 
use the linea functions. 
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get__input( ) 

At first glance, the get— inputC ) function might look like an 
infinite loop. At least, it starts out like one. At the beginning 
of the loop, we print the prompt string =>. Next, we read in a 
line of text, into the buffer pointed to by s. If getsC ) returns a 
NULL, then we read the end-of-file marker, or there was an 
error. We have to tell the routine which called us that, so we 
return SfTTLIi. If we read in a string, then the first character of 
the array (pointed to by s) will have some value, so we break 
out of the loop and return a pointer to the string. If the first 
character of the array is 0, we've read in a blank line, so we 
switch which screen is displayed. 

set_pen( ) 

This routine does different things depending on whether it's 
running on a color or a monochome monitor. If x_size is 320, 
then we're using a color display, so we call the VDI routine 
vsL_col9rC ) to set the current drawing color. We also set 
real— intensity to be consistent with what happens with the 
monochrome monitor. If we're on the monochrome monitor, 
we simply put the value of the color in real— intensity. The 
pattern of the line will be set when the line is actually drawn. 
Notice that we use the translation table mon_ color[ ] to build 
the colors out of the different grey shades. 

move( ), draw( ), plot( ) 

The moveC ) command is only simulated on the Atari. We 
simply set the x_ save and y_ save variables to the values of 
the passed x and y. When drawC ) is called, we draw a line 
from (x_save, y_save) to the (x,y) coordinates passed into 
drawO drawO also sets the pattern of the line if it's being 
used on the monochrome screen. The pattern is determined by 
the value of real— intensity. Notice that the call to 
ABLINBC ) (the linea line-drawing function) is surrounded by 
calls to usescreenC ). This makes the ABLX2HSC ) draw the 
line on the graphics screen rather than the text screen. We 
have to keep the text screen the current display; otherwise 
printfC )s outside the graphics library might go to the wrong 
display. 

plot( ) is much like drawC ). Notice that the calling con- 
ventions for ABLINTEC ) and PTJTPIXC ) are entirely different 
from one another. As with the call to ABLINTSC ),we've sur- 
rounded the call to PTTTPEKC ) in calls to usescreenC ). 
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clear( ) 

The slearC ) command is a true software hack. It violates all 
of the rules of AES, VDI, and even linea. Unfortunately, it 
was entirely necessary. It turns out that the VDI routine to 
clear the screen destroys some of the pointers we've set up to 
use linea. To avoid this problem, we simply replaced the VDI 
function with a short loop which writes zeros directly into 
screen memory. We use a long pointer so that four bytes are 
written for each iteration of the loop. This means we only 
have to write to memory 8000 times to clear the screen. 

punt( ) 

puntC ) offers a very quick way out of a program. It calls 
exit— graphicsC ) with the string it was passed, and then exits 
the program with an error code of 1. 

usescreen( ), showscreen( ) 

usescreenC) changes the logical screen with a call to the ex- 
tended bios function SetscreenC ). Note that SetscreenC ) is 
really a macro defined in the file osbind.h. snowscreenC ) is 
almost identical to usescreenC )/ but changes the physical 
screen, rather than the logical one. Remember, the physical 
screen is the one which is being displayed on the monitor, 
while the logical screen is the one which is being drawn in by 
the linea functions. 

atoi( ), gets( ) 

These two functions have been added to the library for the 
users of Alcyon C. atoiC ) was left out of the gemlib library, 
and the getsC ) function which is provided is faulty. 

linea.c 

It turns out that there is no way to generate a linea instruc- 
tion in C. Most of the compilers offer access to an assembler. 
The linea.c module is the assembly language interface to the 
linea functions. The syntax for assembly language program- 
ming in the Megamax and Alcyon compilers differs, but the as- 
sembly code is identical. Note that the Lattice compiler doesn't 
offer an interface to the assembler; thus we've had to hand as- 
semble the small functions. We've declared them as arrays. 
This is generally poor practice, but we were somewhat desper- 
ate. If you're using a compiler we didn't support explicitly, try 
writing your own assembly language interface first. If that 
doesn't work, try using the arrays. 
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Apdygon^dge which intersects the scan line currently being 
drawn. 

address operators . 

The operators which relate to the addressing of variables. 

Application Environment Services. This is the highest level in 
the GEM programming environment. 

ambient lighting 

The general, background lighting by which all objects are 
slighfly illuminated, no matter where the light source may be. 

thT?p££ing system used by the Amiga. AmigaDOS takes 
care of the files and disk access. 

angle brackets 

The "<" and ">" pair. 

antialiasing , , , . 

Usine grey shades to smooth the edges of polygons or lines, 
more generally, smoothing out the jagged appearance of an 
image on a raster display. 

arbitrary constants . 

Limitations which are inherent in a program for no particular 
reason. For example, the length of an input line or the maxi- 
mum number of elements in some dynamic array. 

argument 

A piece of data passed to a function or a program. 

arithmetic operators , 

The operators which relate to the arithmetic operations, such 

as +, — , *, and /. 
assembly language 

The mnemonic codes which are converted into machine lan- 
guage by an assembler program, the only language the com- 
puter can execute directly. 
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dithering 

A technique of displaying grey shades on a monochrome 
monitor by carefully distributing the location of the "on" 
pixels. 

dot product 

A way of multiplying two vectors, 
executable 

A program which can be run. On the Atari, executables have 
the suffix .TOS, .TTP, or .PRC Under AmigaDOS, executables 
have no such special suffix, and look like ordinary files. 

expression 

A series of values and operators, 
external 

Describes things which are outside the current object module, 
float 

Floating point. A number which may have a fractional part. 
The precision of the number depends on the implementation 
of C and your machine. 

formal parameter 

The arguments to a function. 

front-end 

Something which is in front of something else. With reference 
to programs, a front-end is a program which calls other pro- 
grams. Using some of the compilers can be difficult because 
they aie broken into several small programs which have to be 
run in sequence on a given source file. The front-end will run 
all of these programs for you, so you won't have to worry 
about it. 

function 

A part of the program which accepts values and returns oth- 
ers, or performs some kind of action. 

GEM 

The Graphics Environment Manager. It consists of two parts, 
the VDI and the AES. It is the set of routines which make up 
the windowing environment on the Atari ST. 

global variable 

A variable which can be used throughout the program. 
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halftoning 

Any of a number of techniques to display shades of grey on a 
monochrome display monitor. 

heap 

The section of memory available for a program to use. 
hexadecimal 

Refers to the base- 16 numbering system, 
hidden-surface removal 

The three-dimensional display technique that generates 
onscreen only that part of an image which is visible to the 
viewer. Hidden surfaces are removed. 

high-level language 

BASIC and Pascal are examples of high-level languages. These 
are languages which are separate from the machine on which 
they are being used. Programmers who use high-level lan- 
guages must use an interpreter or a compiler to convert their 
high-level programs into the binary coded instructions the 
computer can run. High-level languages are often subject to 
national and international standardization committees. 

homogenous coordinate system 

The coordinate system used in computer graphics to allow 
generalized matrix multiplication to transform vectors. Rather 
than just an (x,y,z) triplet of numbers, in a homogenous co- 
ordinate system each vector Or point is defined by four values, 
(x,y,z,h). 

increment 

To increase by one. When the " + +" (increment) operator is 
used on a pointer, the pointer is made to point to the succeed- 
ing element in the array. 

integer 

Number with no fractional part, 
interpreter 

A program which reads in complex instructions and interprets 
them for the processor, so that it seems the processor is exe- 
cuting your high-level language program directly. 

Intuition 

The highest level in the Amiga's graphics system. Intuition is 
responsible for the windows, icons, and screens. 
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patterring 

The use of a small group of pixels (typically a 2 X 2 or 3 X 3 
group) to display different "intensities" on the screen by vary- 
ing the number of pixels turned on within the block. 

permanence 

When and how long a variable holds a value. Contrast with 
scope. 

perpendicular 

At a right angle to. 

perspective projection 

A projection that creates an illusion of perspective by making 
all lines disappear towards infinity. 

perspective transform 

A transform which warps an image in such a way that, when 
displayed with a parallel projection, it looks as if it has been 
displayed with a perspective projection. 

pipelining 

Feeding ;he output of one program or function directly into 
another, without waiting for the first to complete outputting 
everything. 

pixel 

The smallest dot you can get on a screen; an individual picture 
element. 

pointers 

Variables which hold the address of other variables, 
polygon 

Any shape made up of a connected outline of line segments, 
portable 

Functions which are portable can be used on many different 
compilers and computers and will always do the same thing 
regardless of where they are used. 

precedence 

The orde] in which operators and expressions are evaluated. 
This is sometimes called binding. 

preprocessor 

The first pass through the source code when the compiler is 
working cn the program. It strips comments out, and executes 
the preprocessor commands. 



processor 

See central processor. 

projection 

A flattening of a three-dimensional object into two dimensions 
so that it can be displayed on a computer screen. The standard 
projections are the parallel and perspective projections. 

protected memory 

A computer with protected memory has the ability to isolate 
the various programs running on it. If a program steps out of 
its allocated memory, the computer forces the program to stop 
running. This prevents one faulty program from corrupting the 
others. 

quotes 

Quotes come in three varieties: " (double), ' (single), and ' 
(back). In C, only double and single quotes have any special 
meaning. 

RAM 

Random Access Memory; computer memory which can be 
written to and read from very quickly. 

raster graphics 

A display that uses only pixels to render information on the 
screen. All microcomputers use raster-graphics displays. 

recursive 

A function which is recursive calls itself over and over again, 
reference 

Function arguments which are passed by reference are passed 
by handing the function the location of the variable rather 
than the variable's actual value. Contrast with value. 

register 

A special location within the processor which can hold a small 
amount of information. Access to processor registers is much 
faster than access to memory. 

relational operators 

Operators which let you compare one value against another, 
result 

The value passed back by a function. 



LLP 



•sppq a t q B UBA aq; an p? A jo pupf , BHM 
(aiqniJBA jo) attt? 
•spueiado aajq; S3>fB; q3 j V{M JO;eJado uy 
•rojBjado ajbuij} 
•Jaq;ouB o; ;uiod auo uiojj Suiao^ 

pafoid jo 'Ma^s 'mojS 'yuuus 'aiBisupjn 
'aw« o, 'ajdujExa joj-uoujsbj avuos ut 

UIJOJSUBJ} 

, "SOaWHO Pub waoSuipnpui 'tc uBjvam 
Su ^ ado ^nruipd aq; ^a;sA s ^Eja^j pS 

SOiL 

•JEqo jo Aejjb U y 
Suijjs 

uopouni e unpiM a§EJo;s auaueuuad 'a 1BA ud api AO jd 
nq 'vuezSojd ajqua aq; o; a iqB „ BAB ; OU aj B 
pa;ixa si uonounj aq; uaqM Suuwdtfwip u B q; 
U| uibui* Aaq; p UB ^ poui pa[ ^ ^ 

SB J0 P«F»P si qoiqM uoipunj b J 3 , qB ^ 

OI)B)S 

b ipiM pa;Euiuiia; 'uiBjSojd D B ui ;iun 

juama;Bjs 

uo .saAa jhoa" o;ui p afqo ue jjo Apoajip spanaj ;eq, iqS ?I ^ 

uoijoauaj jBjnoads 
•jandutoD aq; o; paaj noA qoiq M uiBjSojd aq; jo ;xa; aq X 

apoa aaanos 
'adois aiiunui ub 

aABq saun [BDnjaA P ue < x }Q adojs B a AB q sauq ibuoSei'p in si 
do IS aq: 'sauq [B;uoziJoq ioj -sasu auq e qotqM , B a[SuB aqj] 

ado[S 

•sasn ;i qoiqM s;iq jo jaqumu aq; .';ui ue jo 

azis 



01* 



•auq; B }B 

uiBiSojd auo uiu A\uo ubo §ui>{SB;-a];SuTS si qotqM ja;nduio3 y 

•jaq;ouE 

jo uoipaaip auo ui a§Buii ub A\a>js o; pasn uijojsuej; aqx 

ui jojsubj} JBaqs 

■SDiqdBjS fEuoisuaimp-aajq; ui SuiMopBqs puB §ui 
-;qSq jadojd aq; q;iM spatqo Av\ds\p o; pasn sanbtuqoa; aqx 

SuipBqs 

•ajB Xaq; ;sqAv uiB^dxa Xaq; ;Bq; Xbm b qons ui pauiBU ajB 
s;ub;suod XjBj;iqjB s ( uiBjSojd aq; puB op Aaq; ;sqM aquasap 
;Bq; sauiBu {Baj aABq sajqBtJBA susaui siqx -s>[JOm uiBjSojd aq; 
A\oq puB;sjapun o; s;uauiuioD [Bpads Xub paau ; ( uop noX ;Bq; 
Xbav b qans ui ua;;iJM si Sui;uauinoop-jps si qoiqM uiBjSojd y 

3npaauinoop-jps 

•uaajos aq; uo s;uiod a[qB;;ojd o;ui b;bp 
pa(qo {Buu aq; uijojsubj; o; pasn xlueui uoi;buijojsubj; aqx 

uijojsubjj uaajos 

■doimimuxdd q;iM ;sbj;uo^ -dn\va v sp\oi{ djqvuva 
v Udi{cn uiojj ;uajajjip si siqx -pasn aq ubd a^qBUBA b uaqM 

adoas 

•uaajos aq; uo auq auo 
aui| ubos 

uopaA b ;ou 'iaquinu a{duiis y 

JBJBOS 

•auq b jo spua aq; ;b sa;BuipjooD x aq; uaaMpq aouajajjip aqx 
- saB JBUioiiJEd b punoJB JopaA b 3;b;oj q^iqM xij;bui y 

XTjqBUI UOpB^OJ 

•o; ua;;iJM aq ;ouubd puE uiojj psaj 
aq Ajuo ubd qDtqM Xjouiaui ja;nduioD .'AjouiajAl X^uo-peaH 

woa 

■auq aq; jo spua aq; ;b sa;BuipjooD-/i aq; uaaM;aq 
aouajajjip aq; 'XqBuuoj f^sasu,, auq e qDiqM Aq ;unouiE aqx 

asij 



type casting 

Forcing tie compiler to convert a variable from one type to 
another. 

unary operator 

An operaor which takes only one operand, 
undefined 

The valut of an auto variable before it is initialized; it will 
hold an unknown and unpredictable value. 

UNIX 

A popular operating system from AT&T. It is used widely in 
industry md academia. 

unsigned 

Describes a number which is always considered positive, 
value 

Arguments which are passed by value are passed to a function 
by handhg it the actual values stored in the variable, not an 
address b the variable. Contrast with reference. 

VDI 

Virtual Display Interface. The lowest portable access to graph- 
ics in the Atari ST. 

vertex 

The poini where two edges of a polygon intersect, 
viewing coordinates 

The location of the transformed objects in the space in which 
the projection takes place. 

viewpoint 

The location that we are "looking from" in the space, 
viewscrsen 

The "scrten" on which the image is projected. Equivalent to 
the screen of the computer. 

white space 

Spaces, tibs, or new-lines— those characters which don't con- 
tribute anything to the file except to space it out and make it 
more readable. 
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window 

Part of the screen which has been put aside for a special 
purpose. 

workstation 

A specialized computer terminal. Generally, workstations have 
large screens and offer a powerful windowing environment 
which interfaces to a large mainframe computer. 

world coordinates 

The actual locations of the objects in the space in which they 
are defined. For contrast, see viewing coordinates. 
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polygons 298-308 
hree-dimensionsl line 297-98 
hree-dimensional polygon 307-8 
:wo-dimensional 389-97 
ise_polygon( ) 1»4 

,hen-Sutherland algorithm 291, 292, 294, 
302, 307 
lor 323 
mma 17 

mma operator 6*-67 
mmand 17 

mmand line arguments 135-36 
mpatible function 13 
mpiler 3 

jmpiler-Dependtnt Information (table) 35 
:>mpiler Informalion (table) 35 
mpiling instructions 361-68 
.mpiling machim-specific files 347-48 
imposing matricfs 206 
imposite matrix 119-20 
impound statement 60-61 
nested 60 
mcave polygons 300, 302, 306 
mditional compiation 74-75 
mditional expression 59 
)ntinue 67-68 
inversion specifi:ation 17 
snvex polygons i00, 306 
jnvex polyhedron 300 
involution integral 321 
^ordinate space 18 

jp 214, 230. See also center of projection 
opy_vector( ) 226 
os( ) 164 

! programming lmguage 4 

features 5 

history of 5 
ross product 92-95 
ross_product( ) 126 
urved surfaces 321-22 
w 214, 220 
lata file 191-92 
lata points 136 
lata registers 34 
lata types 31 
lebugging commands 75 
lecimal 335 

Decimal, Binary, Octal, and Hexadecimal 

(table) 337 
decimal point 32 
decision making 55 
declare 21 
decrement 43 
define 21 
^define 72, 135 
degenerate edges 302-5 



depth buffer 255-56 
depth sorting 255 
destination vector 226 
differential scaling 208 
diffuse reflection 253-55 
dimension 201 
"display.c" 228, 259-60 

program listing 236-38, 265-67 
distance 90 
dithering 171-72 
dither matrix 171-72 
dither plots 162 
"divide.c" 
compiling 364-65 
program listing 42-43 
divide_vector( ) 226 
division-by-zero error 68 
do loop 64, 65-67 
domath( ) 132 
dot product 92, 96 
dot_product( ) 226 
dot-product function 220 
double 31 

double quotes 24, 103 
double-precision floating-point number 31 
draw() 25, 26, 71, 170 
"draw.c" program listing 153-57 
edge fill algorithm 197-98 
edge flag algorithm 198 
else 55, 61, 63 
#else 74-75 
else if 62-63, 71, 132 
#endif 74-75 

entry structure 122, 124, 126 
escape sequences 15 
exclusive or 51 
execute( ) 72 
exit( ) 71 

exit—graphic ( ) 26 
exponent 32 
expressions 40-43 

as arguments 22-23 
extern 21 
"facte" 
compiling 365 
program listing 69 
fast floating-point arithmetic (FFP) 296 
fclose( ) 134 

"fl5" program listing 284-86 
"figs.c" 
compiling 363-64 
program listing 27 
file 134, 135 

"fileio.c" program listing 149-50 
fill 175, 259 
filling 175 



float 31, 32, 45-47, 83, 107 
floating point 31-32 
floating-point math 165-66, 296 
flood( ) 175 

Floyd-Steinberg algorithm 170-71 

fopen( ) 134 

for 64, 66-67 

formal parameter 17, 39 

fprintf( ) 134 

frame buffer 263 

free( ) 125 

fscanf( ) 192 

function 11-27 

function arguments 21-22 

function name 130 

function, naming 16 

get_input( ) 71, 72 

get_item( ) 193 

"global. c" program listing 37 

global variable 36-39, 70, 87, 130 

glossary 401-13 

Gouraud shading 322 

"graph.c" 

compiling 367-68 

program listing 141-48 
"graph.h" program listing 140-41 
graphics 161-70, 319 

on the Amiga 385-89 

on the Atari ST 391-98 

raster 161-62 

three-dimensional 201-21, 225-32 
graphics library 6, 23 

Amiga 386-89 

Atari ST 392-98 

using 369-74 
graphics programming v 
graph program 

commands 137-38 

using 136-40 
halftoning 170 
header files 72 
head to tail method 90 
"hello. c" 

compiling 362-63 

program listing 6 
"help.c" program listing 157 
hexadecimal 17, 335 
hidden-line code 229 
hidden-line elimination 228-29 
hidden-surface code 229 
hidden surfaces 253 
homogenous coordinate space 207 
homogenous coordinate system 202 
id 194 

identity matrix 99 
IEEE-standard floating-point 296 



if 55, 59, 61-63, 74, 132 

nested 63 
#if 74 

#ifdef 74-75 
. #ifndef 74-75 
illuminating a polygon 253-55 
illumination 322-25 
#include 72 
include path 24 
inclusive or 51 
increment 43 
indenting 60 
index 84 
inequality 56 
infunc 132 

init_graphics( ) 24, 26, 191 
inline[ ] 70 

input/output routines 133 
int 31, 32, 45-47, 83, 123 
integer 17, 32-35 

size 32-33 
integer math 166-70 
intensity 192, 194, 255, 257, 260, 321 
interlacing 162 
invisible lines 290, 304 
jaggies 320 

Lambert's Law 254, 260 

Lattice C 3, 22, 33, 46, 71, 96, 125, 169, 

228, 341-42, 344 
left-handed coordinate system 93 
library 4 
light 253 

light ray (tracing) 325 
line( ) 164 
line 202 

"line2.c" program listing 164 
"line3.c" program listing 166-67 
"line4.c" program listing 168-69 
"line5.c" program listing 169 
"linea.c" program listing, ST 358-59 
line drawing 162-70 
linked list 122, 125-30 

circular 129 

double 129 

figure 129 

single 128, 130 
linker 4 
LISP 39 

local variable 36, 38, 61 

logical Boolean operators 55, 57-58 

logic expressions 55 

log-log graphs 130 

long 33 

looping command 108 
loops 64-70 
control commands 67-68 
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transformation matrix 216-21, 225 

transforminf vectors with matrices 203-14 

transform right to left (T RL ) 217 

translation 307 

translucencj 324 

transparency 324 

binary operators 40 

T RL matrix 217, 220 

two-dimensional array 86-87, 96 

type casting 71, 124 

type-castinj operators 47-48 

typedef 135 

typing in machine-specific files 34/ 
umax 213 
umin 213 

unary opentors 39 
undefined /ariable 32 
uniform selling 208 
unit vector 91 
unsigned 33 
uppercase 73 

variables 31-39, 105, 119 

declarinj 35-36 

global 3>-39 

static 36 
v_contourfill( ) 1 75 
vector 201, 225 
vector( ) 226 
"vector.c" 

compiliig 366 

program listing 109-15 
vectors 87-96 

defining 95-96 



normalized 90-92 

reflecting 98 

rotating 99, 100 

scaling 90-92, 100 

three-dimensional 92-93 

transforming 99 

using 88-90 
vertex count 192 
v_fiUarea( ) 177 
viewing coordinates 216 
viewplane 214 
viewplane normal 215 
viewplane reference point 215 
viewplane up 215 
viewpoint 214-16 
visible lines 290, 304 
vmax 213 
vmin 213 
void 70 
vpn 215, 216 
vrp 214 
vup 215, 216 

Weiler-Atherton algorithm 306-7 

while 64, 65-67 

windows 289 

wire mesh 259 

world coordinates 216 

xor operator 51 

xor (Truth Table for) 52 

2-buffer algorithm 253, 255-64 

data files 257, 263-64 
zero byte 103 

"zgon" program listing 283 
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To order your copy of Learning C: Programming Graphics 
on the Amiga and Atari ST Disk, call our toll-free US order 
line: 1 -800-346-6767 (in NY 212-887-8525) or send your pre- 
paid order to: 

Learning C: Programming Graphics on the 

Amiga and Atari ST Disk 
COMPUTE! Publications 
P.O. Box 5038 
F.D.R. Station 
New York, NY 10150 

All orders must be prepaid (check, charge, or money order). NC 
residents add 5% sales tax. NY residents add 8.25% sales tax. 

Please check the version you need. 

Amiga (645DSK1) $15.95 

Atari ST (645DSK2) $15.95 

Subtotal $ 

Shipping and Handling: $2.00/disk $ 

Sales tax (if applicable) $ 

Total payment enclosed $ 

□ Payment enclosed 

□ Charge □ Visa □ MasterCard □ American Express 



Acct. No. Exp. Date 

(Required) 



Name 



Address 



City State Zip 

Please allow 4-5 weeks for delivery. 
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